project-management | github | gitlab | jira | style-guide

Project management - Organize issues using labels

by Abhith RajanFebruary 06, 2019 · 3 min read · Last Updated:

Labels are a good way to categorize the tasks. But having too many in an unorganized way results more clutter. Here is my way of labeling issues/tasks. This is the way I organize my tasks in GitHub, GitLab and in Jira.

Area

Indicating the area to which issues belong.

LabelDescriptionColor
area:optimizationFine tuning works#8bd9e5
area:documentation
area:security
area:uxUser experience#ccbef7

Priority

Used to prioritize the issues.

LabelDescriptionColor
priority:highRequires immediate attention#d93f0b
priority:mediumRequires attention soon
priority:lowDoes not require immediate attention

Stage

Indicating the current stage of the issue.

LabelDescriptionColor
stage:investigatingSomeone is looking into this
stage:wontfixDoes not regard this as an issue or will not implement this feature
stage:backlogPrioritized to be picked up in current sprint
stage:proposalNo work has been done of this issue
stage:awaiting responsePotential fix was proposed; awaiting response
stage:pending releaseWorks associated with this issue is done but not deployed
stage:ready for workThe issue is reproducible and in scope
stage:needs informationNot enough info to reproduce the issue
stage:needs reviewWork done but needs review
stage:needs investigatingSomeone needs to look at this
stage:work in progressSomeone is working on it#68db1c
stage:testDeployed to TEST environment

Stage labels like in progress, backlog etc can be skipped in GitHub if you linked the issue to a project which has relevant columns matching these stages.

Type

Used to categorize the issues.

LabelDescriptionColor
type:breaking changeRequires a new major release version
type:bug#ee0701
type:choreWork is required w/ no deliverable to end user
type:commentComments created via utteranc.es#893aff
type:duplicateThis issue already exists
type:featureNew feature that does not currently exist#62fcbe
type:enhancementRequested enhancement of existing feature#6550ba
type:question
type:user experienceImprovements needed for UX

If you are a colorful person 😉 , suggest me some colors for these labels in the comments 👇

Abhith Rajan

Written by Abhith Rajan
Abhith Rajan is an aspiring software engineer with more than 7 years of experience and proven successful track record of delivering technology-based products and services.
Buy me a coffee

Was this article helpful?

Your opinion matters

Please share your thought about this article

This page is open source. Noticed a typo? Or something unclear?
Improve this page on GitHub

Related Services

GitHub Contributions Chart Generator

See all of your GitHub contributions in one image!

Utterances

A lightweight commenting system using GitHub issues.