Skip to content

ConvDev Index

Resources

FE @psimyn | BE @adamniedzielski | UX @tauriedavis | PM @victorwu

Customers

  • Customers view how they are using GitLab from a feature perspective.
  • View how they compare with other organizations, and see how far they are away from a better metric.
  • Discover features that they are not already using, or using incompletely.
  • Learn about best practices by visiting relevant blog posts and white papers.
  • Self-service inside their GitLab instance.

Sales

  • Sales team views exactly same information as the customer, for ongoing relationship management and sales opportunities.
  • When conversing with customers, refer to same exact view so easily have a coherent conversation.
  • View from within version.gitlab.com and know that it is the same view as customer's (who is viewing it from their GitLab instance.) https://dev.gitlab.org/gitlab/version-gitlab-com/issues/55

Scope for this issue

  • View is only accessible if the instance has usage ping configured on.

  • Only instance admin has access to the view.

  • Metrics

    • View how many objects created in last 30 days of data for a given metric.
    • The metrics are calculated on version.gitlab.com and returned back to the customer's GitLab instance to display. Details at: https://dev.gitlab.org/gitlab/version-gitlab-com/issues/56.
      • This includes individual metrics.
      • This includes the aggregate Conversational Development Index.

Design

Colors

  • Colors apply to the individual metrics (the boxes), and also the convdev index score itself, and the I2P icons.
  • [0, 33.33): Red
  • [33.33, 66.66): Orange

Top information appears on first visit until the user dismisses it:

convdev__index-v02--info-message

View without top information:

convdev__index-v02--graphic-resting

Hovering over an item in the bottom timeline graphic expands the graphic to show I2P stage name. The color of the icon reflects the average of the features it relates to, per the color scheme above, and the averages per:

  • Idea - issues
  • Issue - average of issues and comments
  • Plan - average of milestones and boards
  • Code - merge requests
  • Commit - merge requests
  • Test - pipelines
  • Review - average of pipelines and environments
  • Staging - average of environments and deployments
  • Production - deployments
  • Feedback - average of monitoring and service desk

convdev__index-v02--graphic-hover

Timeline graphic will only appear on larger screens. Columns will wrap at smaller screen sizes and so the timeline graphic would no longer equate to the features correctly.

Empty state: Usage ping not enabled

convdex-is-not-enabled

Empty state: No data yet

convdex-no-data

Assets

Top info graphic: illustration-convdev.svg

Icons: https://gitlab.com/gitlab-com/marketing/tree/master/design/web-design/about-gitlab-com/home-page/_artwork/_assets/10-step-icons-clean

Empty state svgs:

icn-convdev--no-index.svg

icn-convdev--no-data.svg

Documentation and blog post / article / white paper links

Doc Blog post / article / white paper
Issues Digital collaboration by Deloitte
Comments Why conversational development?
Milestones Link ConvDev Principle 1: Shorten the conversation cycle
Boards Link User Story Mapping by Jeff Patton
Merge requests Link The Humble Craftsman by Uncle Bob
Pipelines Link Continuous Delivery by Martin Fowler
Environments Link GitLab CI: Deployment & Environments
Deployments Continuous Delivery Vs. Continuous Deployment: What's the Diff? by Puppet
Monitored projects coverage Link Prometheus Overview
Service desk issues Link Top Trends for Customer Service by Forrester

Data flow

  1. Metrics are calculated on version.gitlab.com server - instance score, leader score, level (low, medium, high)
  2. Metrics are transferred as the response to usage ping
  3. Metrics are saved in the database of the GitLab instance
  4. Rendering the ConvDev Index page doesn't cause any additional requests to version.gitlab.com

Related

Edited by Victor Wu