Managing Cross-Repo Milestones

Create the same Milestone across a multi-repo Board

If you've created a multi-repo task Board, ZenHub makes it easy to create a GitHub Milestone spanning several repositories. This eliminates the need to duplicate work or sync Milestones together. To get started, find the + beside the New Issue button on the ZenHub Board.Creating cross-repo milestones

Currently, both Milestones must be exactly the same to merge together as one. Otherwise, they'll appear separately in your reports and task Boards. That means they must have the same:

  • Name
  • Start and end date

As long as the above two conditions are met, you can successfully merge Milestones before or after you connect task Boards.

By default, when using the + button to create Milestones, all connected repos will be selected in the dropdown. If you want to create a Milestone in only a few of the connected repos, click on the dropdown and de-select the repos where you do not want the Milestone to appear.Entering Milestone details

In the ZenHub Web App teams can also create Milestones across connected workspaces using the Milestone page and selecting the New Milestone button.Creating cross-repo Milestones in the Web App

Editing and closing cross-repo Milestones

To bulk edit and close Milestones across connected workspaces, head to the ZenHub Web App and navigate to your multi-repo Board. The Milestone page can be used to bulk edit and close open Milestones across connected repos. All open Milestones will appear on this page. Use the Edit Milestone or Close Milestone buttons make bulk changes.

Once Milestones get closed in bulk they cannot be re-opened in bulk. To re-open connected Milestones, head to the specific repository where the Milestone is located and use the re-open Milestone option native in GitHub.

Managing Milestones Cross-Repo

When a Milestone is connected across multiple repos, hover over the details text on the right of each Milestone to see what repos the Milestone belongs to.Connected repos and Milestones