Working with ZenHub
How to use Zenhub in team squads
ZenHub is “agile project management within Github”. We use it for all squads in the design team.
Current squad boards:
- Iterations are two weeks. They start on a Tuesday and finish on a Monday.
- Each iteration should be a milestone in ZenHub in the format
Iteration [startyear]-[startweek] [startdate] [startmonth] - [enddate] [endmonth].
Iteration 18-27 3rd July - 16th July followed by
Iteration 18-29 - 17th July - 30th July.
- Each milestone (iteration) should include all epics to be worked on.
- Epics should have everyone who will be working on it assigned.
- Epics should be in the
- Epics should have a description explaining the goal.
- Issues for the current milestone should start in the
- There should be one issue per person in the
- Issues should have one assignee at any one time. If an issue requires multiple people at different stages it should be handed over and the assignee changed at the appropriate time. When reassigned, issues should be moved back into the
- Issues that are part of an epic should have an estimate based on the fibonacci estimation guide.
- If for some reason you move to a different issue before completing your current issue, that issue should be labelled as “blocked”.
- Issues should have a description if the title isn’t obvious.
- Issues do not need to be part of an epic, but most should.
These are the lanes/ columns/ groups of issues and epics on ZenHub. Generally issues move from left to right as they progress.
Where issues are born. This is a general bucket of all the issues that have been and will be that have yet to be scoped or agreed on.
Issues that are scoped and ready to be picked up at some point in a future iteration/ if there’s time left at the end of an iteration.
It’s of utmost importance that triaged issues are prioritised.
At the end of an iteration these should be either closed (if all issues are complete) or moved to the next milestone.
Issues waiting to be picked up in the current iteration. These are either issues that are yet to be started, have been reassigned or are on hold.
Issues being actively worked on.
Only one issue per person in the squad should be here. As much as we’d like, we can’t work on 5 things at once.
If you’re waiting for something/ someone to continue work on an issue, label it as “blocked”.
If you need to move on to something with a higher priority move any issue you’re assigned but not working on back to
Any issue that is deemed code/ UX/ design complete but requires a review or QA.
Anything that is complete. The final resting place for issues and epics.