Arrow left
Blog Homepage

Track Velocity on GitHub Repositories with Multi-Repo Burndown Charts

Track Velocity on GitHub Repositories with Multi-Repo Burndown Charts

Editor’s note: This blog post was originally published in March 2016 and has been completely revamped and updated for accuracy and comprehensiveness.

For project managers, tracking progress toward upcoming releases is crucial. But when projects span several GitHub repos (as they often do), seeing the whole picture can be difficult. With Multi-Repo Burndown Charts, teams can track progress for a multi-repo milestone. This provides teams with a complete visualization of all completed and remaining work within a sprint.

Multi-Repo Burndown Charts made with Zenhub

Here's how to get started:

1. Connect repositories into one Zenhub Workspace

Multi-Repo Boards are a simple way to track issues from several repositories in one place. Click here to learn how.

2. Create a multi-repo milestone

Burndown Charts are meant to track velocity during short sprints of work – and as such, they are integrated directly with your GitHub Milestones.

Hit the + icon beside the 'New Issue' button to create a milestone spanning repositories:
Creating a milestone spanning across multiple repositories

Once you have created your milestone with a start date and end date, navigate back to the Board. You can use multi-action to select multiple (estimated) Issues to be added to the Sprint.

Click here to learn more.

3. Navigate to your Burndown Report

Your Burndown Charts can be accessed via the 'Reports' section in the sidebar of your Workspace (or by using the keyboard shortcut z + d). The repos you've connected into your Multi-Repo Board will appear together here. You can check or uncheck repos to filter your Burndown Chart.

3. Select a Milestone

Choose a Milestone from the drop-down filter on the right of a workspace

Choose a Milestone from the drop-down filter on the right. Zenhub Burndown's will be available for the last 10 closed Milestones. You can also export the report to CSV to further customize and analyse data.

4. Track your progress!

After choosing a Milestone, all Issues which have been assigned a story-point estimate will appear on the Burndown Chart. As you finish Issues assigned to the Sprint, a new data point will appear, "stepping down" in the chart.

You can also check out our help article for more information on Burndown Charts!

Questions? Ideas? Shoot us an [email](mailto: support@zenhub.com) or chat with us on Twitter!


Project Management
Newsletter Icon