project-management | github | gitlab | style-guide

Project management - Organize issues using labels

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

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
area:documentation
area:security

Priority

Used to prioritize the issues.

LabelDescriptionColor
priority:highRequires immediate attention
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 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:bug#E54447
type:choreWork is required w/ no deliverable to end user
type:duplicateThis issue already exists
type:featureNew feature that does not currently exist
type:question
type:enhancementRequested enhancement of existing feature
type:breaking changeRequires a new major release version
type:user experienceImprovements needed for UX

Colors will be updated later (Or you can suggest).

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

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

Related Services

Sourcetree | Free Git GUI for Mac and Windows

A Git GUI that offers a visual representation of your repositories. Sourcetree is a free Git client for Windows and Mac. It supports Git-flow out of the box.