This document describes how we track issues for the After-Party tracking on the project board is at https://github.com/orgs/sanger-tol/projects/3.
Our workflow has three main steps:
- Todo: This item hasn't been started.
- In progress: This is actively being worked on.
- Done: This has been completed.
with the addition of:
- Triage: This item first needs to be confirmed or refined. Triage is optional, but would typically be used before Todo.
- Blocked: This item is waiting on another one and can't be worked on.
We follow a simple model with three priority levels:
- High
- Medium
- Low
There is a first set of labels about the kind of issue, that are mutually exclusive and should be set to almost every issue:
-
bug
Something isn't working : Something isn't working -
enhancement
Improvement of the existing features : Improvement of the existing features -
feature
Requests for new features : New feature or request -
maintain
Tasks to keep pipelines up to date : Tasks to keep pipelines up to date
Most issues are expected to be about the code (software), but we have those two labels for non-code issues:
-
documentation
Improvements or additions to documentation : Improvements or additions to documentation -
testing
Code testing : Code testing
These labels are used to indicate why an issue is closed early:
-
duplicate
This issue or pull request already exists : This issue or pull request already exists -
invalid
This doesn't seem right : This doesn't seem right -
wontfix
This will not be worked on : This will not be worked on
External contributors can look for these labels:
-
good first issue
Good for newcomers : Good for newcomers -
help wanted
Open to anyone interested : Open to anyone interested
Finally:
-
question
Further information is requested : Further information is requested -
user request
Requests made by users and public : Requests made by users and public
Labels should follow the following rules:
-
bug
Something isn't working , enhancementImprovement of the existing features , featureRequests for new features , and maintainTasks to keep pipelines up to date are mutually exclusive. - Almost every issue should have one of
bug
Something isn't working , enhancementImprovement of the existing features , featureRequests for new features , or maintainTasks to keep pipelines up to date . - All issues with
duplicate
This issue or pull request already exists , invalidThis doesn't seem right , or wontfixThis will not be worked on , should be Done. - All issues in Triage should have the
question
Further information is requested . - Only Low priority issues should have the
help wanted
Open to anyone interested . This is to ensure we don't clash.