GitHub Issues – Do you customize your labels?

Last updated by Tiago Araújo [SSW] about 2 years ago.See history

Labels are an important way of categorizing your GitHub Issues. However, it is critical to make sure they are useful, clear and do not overwhelm users.

The goal is to use consistent labels across all repos. 

Let's take a look at how to make a simple, yet information rich set of labels...

Firstly, set up some GitHub Issue Templates that have default labels. Prefix those ones with "Type:" so it is clear they define the type of Issue:

  • Type: Bug
  • Type: DevOps
  • Type: Documentation
  • Type: Feature
  • Type: Refactor

Also add some extra labels for important ancillary information. Try not to go overboard though, a good example might be 3:

Some labels to define the area of work:

  • Area: Frontend
  • Area: Backend

And the standard GitHub label to indicate it is a good Issue for developers new to the project:

  • Good First Issue

badlabels
Figure: Bad Example - using Effort labels is not ideal for GitHub Issues

Learn more about where Effort labels are appropriate with GitHub Projects, which has custom fields.

extralabels
Figure: Good Example - Add a few labels beyond the ones that are set based on the Issue Templates

We open source. Powered by GitHub