GitLab Documentation

Burndown Charts

Notes:

  • Introduced in GitLab Enterprise Edition Starter 9.1.
  • Closed or reopened issues prior to GitLab 9.1 won't have a closed_at value, so the burndown chart considers them as closed on the milestone start_date. In that case, a warning will be displayed.

Overview

Burndown Charts are visual representations of the progress of completing a milestone.

burndown chart

At a glance, you see the current state for the completion a given milestone. Without them, you would have to organize the data from the milestone and plot it yourself to have the same sense of progress.

GitLab Enterprise Edition Starter plots it for you and presents it in a clear and beautiful chart.

Use cases

Burndown Charts, in gerenal, are used for tracking and analyzing the completion of a milestone. Therefore, their use cases are tied to the use you are giving to your milestone.

To exemplify, suppose you lead a team of developers in a large company, and you follow this workflow:

How it works

Note: Burndown charts are only available for project milestones. They will be available for group milestones in the future.

A Burndown Chart is available for every project milestone that has been attributed a start date and a due date.

Find your project's Burndown Chart under Project > Issues > Milestones, and select a milestone from your current ones.

The chart indicates the project's progress throughout that milestone (for issues assigned to it).

In particular, it shows how many issues were or are still open for a given day in the milestone's corresponding period.

Since it only tracks when an issue was last closed (and not its full history), the chart assumes that issue was open on days prior to that date. Reopened issues are considered as open on one day after they were closed.

Note that with this design, if you create a new issue in the middle of the milestone period (and assign the milestone to the issue), the Burndown Chart will appear as if the issue was already open at the beginning of the milestone. A workaround is to simply close the issue (so that a closed timestamp is stored in the system), and reopen it to ge the desired effect, with a rise in the chart appearing on the day after. This is what appears in the example below.

The Burndown Chart can also be toggled to display the cumulative open issue weight for a given day. When using this feature, make sure issue weights have been properly assigned, since an open issue with no weight adds zero to the cumulative value.