icon-flow

GitHub Workflows

Visualize My GitHub Workflow

Merging GitHub repositories

Software projects often span across several GitHub repositories, so naturally, your task boards and reports should too!

Using ZenHub, you can connect repositories together – even across GitHub organizations – to get a bird's eye view into everything going on with your software projects. With advanced filters, you can drill down to see only what you need.

Note: Only once you connect repositories into a Multi-Repo Board can you track them together in reports – like velocity and burndown charts – and other features like multi-repo epics. It all starts on the task board.

How to connect GitHub repositories

Connecting repositories is easy. First, navigate to the first repository you want to connect. Visit the Board, click Repositories (at the top of the Board), then select Merge another repository.

zenhub-connect-github-repositories

Next, it's time to set up the structure of this new Multi-Repo Board. You'll be presented with a preview screen where you can drag and drop pipelines to determine how they will be merged. You can always fine-tune these settings later.

Let's say you have two pipelines: “QA” and “Review”. Though their names are different, they serve the same purpose, so you'll want to merge them together into one pipeline. When these pipelines are merged, the “QA” pipeline's issues will appear in the “Review” pipeline.

When you have finished organizing, click Merge to finish.

Merging GitHub Milestones

When you merge repositories together, their milestones can merge too – which makes it easy to track and filter them! 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.

Customizing Your GitHub Task Boards

zenhub-board-edit-name

A well-organized task board can help you uncover bottlenecks faster and provide more information for other stakeholders on the team. While the default board structure is a great starting point for any project, you should consider customizing it to suit your workflow.

When thinking about how to customize your task boards, take an audit of your team's workflow. Look at your boards and ask yourself these questions.

  • Does this structure contain only what we need, and nothing more? Could my boss look at this and understand everything she needs to about the project?
  • Is every important stakeholder represented? Can someone in design, marketing, or QA look at this board and know exactly where his or her help is needed?
  • Are we missing any repeating stages? Think about how your team builds products. It's all about keeping issues flowing across the board. If you have a QA department, for example, you might need a “Ready for QA” pipeline.
  • Is “Done” really done? And does my team know and understand our definition of Done? This often-missed step is a crucial part of any agile project.
Next Lesson:
I want to achieve more with Epics
You’ll learn…
  • A productivity-boosting workflow for Scrum epics in GitHub