Occasionally I’ll think of shiny projects and start chasing them or try to remember them for later. Now when I think of something, I’ll put it in my project repository.

Project Repository

I’m using a single repository to manage all the projects and ideas to backlog and track. The single repo allows my projects that span across different platforms to have single source of management.

Another benefit is the ability to customize the issue template.

ZenHub

My co-worker found ZenHub and we started evaluating it at work. I liked it so much I decided to try it out for personal use. Slowy adopting it but would like to start configuring it for real use. For example, I have a project I’ve built for my parents and if they have problems with it, they can create an issue in GitHub and I’ll get it. 😄

They have a great set of guides that I used for reference.

Hide GitHub Projects (optional)

I was having a hard time understanding the use of managing both Projects and the ZenHub board. This article helped me understand why they discontinued support for projects in Zenhub and the difference between the two. and why I think GitHub projects should be disabled (in your project management repository settings). The article doesn’t mention they have similar functionalities, but the UI and workflow ZenHub provides surpasses GitHub’s Projects board.

Without ZenHub, your GitHub issues lack hierarchy; they’re simply a list. There’s no clear indicator of which issues are related and where the dependencies lie. ZenHub’s Epics add this crucial layer of hierarchy. [Source]

Organization

If you’re familiar with agile story boarding, GitHub has equivient features in their system.

Agile GitHub
Epic Epic
User Story GitHub Issue
Sub-Task Markdown Checklist

Epic

Epics are a items that will take longer than just a sprint and should be broken down into smaller chunks. > Epics contain Issues related in subject, and the scope is flexible. Source]

Issues

Issues should be completed in the smallest amount of time possible and are usually tied to an Epic.

Checklist

Individual tasks needed to complete the issue

Milestones

In GitHub, Milestones = sprints > …milestones are tied to sprints, they contain Issues related by time, and not necessarily related by subject. [Source]

Estimate

This tracks about how much time it would take to complete an issue in points. It’s used to determine which issues could be compeleted and put into a milestone. The total estimate of all issues in an epic is Epic points.

Releases

Release are a snapshot of your code at specific place in time, usually packaged and ready software for users to download.

Labels

Labels help identify the type of work that the issue encompasses. Does it need research, is it bug, enhancement, etc.

GitHub Repositories

If working on specific projects that has a repository or organization on GitHub, adding the repo through ZenHub will display issues from there. This lets you manage not just regular projects, but specific issues side-by-side with your code.