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.
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 besides the 'New Issue' button to create a milestone spanning 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.
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
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. 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!