Burndown charts

About Burndown Charts

Burndown Charts are often associated with Scrum, a development methodology known for incremental releases and a focus on customer requirements. As an agile workflow tool, they help teams meet deadlines more predictably by providing an early indicator of how a project is coming along.

Because they provide a visualization of complete and remaining work, they're also a user-friendly reporting tool for GitHub project management.

Creating Burndown charts in GitHub using ZenHub

Burndown Charts are meant to track velocity during short sprints of work – and as such, they are integrated directly with your GitHub milestones. You'll find your team's Burndown Charts in the Reports tab.

To build your chart, you'll need to choose the milestone start and end dates (find the edit link at the top of the chart.) After choosing a milestone, all the issues which have been estimated will be shown.burndown-change-milestone

Just like kanban boards and epics, Burndown Charts can help you visualize projects across repositories. In ZenHub, each Milestone (sprint) gets its own Burndown Chart.

To create a Burndown chart you first need to assign a start date for your sprint. The due date was already set when you create the Milestone, but the start date of a Milestone is unique to reporting in ZenHub.Adding a start date to Burndown Charts

Select Edit on the top left of the chart to confirm the day you started your sprint.Adding a start date to Burndown Charts

With a start and end date selected, estimated issues with estimates that are added to the Milestone will begin to appear on the Chart. If you haven't yet added estimated issues to a Milestone, or estimated the issues within the Milestone, you'll see an empty state.Burndown chart with no estimated issues

Head back to the Boards tab and filter by your current Milestone to begin estimating issues within your sprint. filtering-by-milestone

You can use the multi-select functionality on the Board to assign estimation to issues from one central view.assigning-estimates

When an issue is closed, a new data point will appear. issues-closed-in-burndown

Along the middle of the graph is a light-gray, dotted line—This line represents the speed at which you need to be closing or completing issues within your sprint to complete all issues you've set out to achieve in the sprint. You can be confident you’ll achieve your goal if your team’s completed work closely aligns to this diagonal timeline.

Defining what is "done" using burn pipelines

By default, Burndown Charts display closed issues and pull requests as data points. You can also customize which pipeline triggers a “burned” task by using the Burn Pipelines dropdown menu. For example, if your development team considers a task complete when it reaches the “Ready for QA” pipeline, they can set that here for a more accurate picture of their priorities and progress.select-burn-pipeline

Creating multi-repo Burndown charts

To create a multi-repository Burndown Chart, you'll need to start by connecting repos on the Board.

In addition, you also have to make sure the same Milestone, with the exact same name and end date exists across all repos you'd like to track together.

Create the same Milestone across your connected repos using the multi-repo Milestone creator. Learn more here.

You'll then see the connected repositories listed at the top of the chart, and any merged milestones will appear together as one.new-milestone

Close out a sprint to complete the Burndown

Close the Milestone at the end of a sprint in the same section where you create the Milestone, under the Issues tab.new-milestone

On the right of every open Milestone is an option to close. Once closed, you can still filter the Board and view all issues that went into the Sprint; however, one of the key benefits of closing a sprint is that it provides additional reporting around your team's average velocity.close-milestone