docs/process/labels.md
This section outlines the labels currently used in the project, and adds context about what each label represents.
These labels are used for both issues and pull requests, and are assigned to help understand the type of work involved.
| Label name | Description | |
|---|---|---|
| :mag_right: | docs | Issues and pull requests related to documentation work on the project |
| :mag_right: | infrastructure | Issues and pull requests related to scripts and tooling for GitHub Desktop |
| :mag_right: | tech-debt | Issues and pull requests related to addressing technical debt or improving the codebase |
This section is organized into sub-groups, as groups of labels relate to specific work being done in the issue tracker.
The triage process is how the maintainers process incoming issues and prioritize the work required to address the feedback raised. These labels help us to track the flow of an issue through this process
| Label name | Description | |
|---|---|---|
| :mag_right: | bug | Confirmed bugs or reports that are very likely to be bugs |
| :mag_right: | enhancement | Issues that propose to improve the app and solve a problem for users |
| :mag_right: | investigation-needed | Likely bugs, but haven't been reliably reproduced by a reviewer |
| :mag_right: | more-information-needed | The submitter needs to provide more information about the issue |
| :mag_right: | priority-1 | Major bug affecting large population and inhibiting their work |
| :mag_right: | priority-2 | Bug that affects more than a few users in a meaningful way but doesn't prevent core functions |
| :mag_right: | priority-3 | Bugs that affect small number of users and/or relatively cosmetic in nature |
| :mag_right: | support | Issues specific to an individual users' configuration requiring diagnosis and clarification to resolve |
We use these labels to identify work that is ideal for external contributors to get involved with.
| Label name | Description | |
|---|---|---|
| :mag_right: | good first issue | Issues marked as ideal for a brand new contributor to start with |
| :mag_right: | help wanted | Issues marked as ideal for external contributors |
We use these labels to track tasks outside the usual flow of addressing bugs or implementing features:
| Label name | Description | |
|---|---|---|
| :mag_right: | meta | Issues used to co-ordinate tasks or discuss a feature before the required work is captured |
| :mag_right: | user-research | Issues that may benefit from user interviews, validations, and/or usability testing |
| :mag_right: | needs-design-input | Issues that require design input from the core team before the work can be started |
As we work on new parts of the application or refine existing workflows, we use
epic labels, ex: epic:rebase to track issues and PRs that are part of a common feature focus area, or epic.
This label is intended to make searching for issues related to an epic easier, and a project board should be used to organize and prioritize the work within an epic based on the upcoming release schedule.
Each label should be removed from the repository when the project board is closed, so these labels do not become overused and add noise to the issue tracker.
| Label name | Description | |
|---|---|---|
| :mag_right: | epic:stashing | Supporting stashing uncommitted changes in the app |
We use these labels to identify issues related to a specific area or the app, or a specific subset of users:
| Label name | Description | |
|---|---|---|
| :mag_right: | codemirror | Issues related to our use of CodeMirror that may require upstream fixes |
| :mag_right: | electron | Issues related to our use of Electron that may need updates to Electron or upstream fixes |
| :mag_right: | integrations | Issues related to editor and shell integrations that ship in Desktop |
| :mag_right: | performance | Relating to things affecting performance |
| :mag_right: | themes | Issues related the light or dark themes that ship in Desktop |
| :mag_right: | website | Issues that relate to external websites and require co-ordination to resolve |
Sometimes issues are isolated to a specific operating system. We use these labels to help identify these issues, so maintainers with that setup - or experience with that setup - can easily find them in the issue tracker.
| Label name | Description | |
|---|---|---|
| :mag_right: | linux | Issues specific to Desktop usage on Linux |
| :mag_right: | macOS | Issues specific to Desktop usage on macOS |
| :mag_right: | windows | Issues specific Desktop usage on Windows |
These labels should only be assigned to pull requests, and are intended to help reviewers navigate the open contributions to identify how best to spend their time:
| Label name | Description | |
|---|---|---|
| :mag_right: | ready-for-review | Pull Requests that are ready to be reviewed by the maintainers |
| :mag_right: | time-sensitive | Pull Requests that require review in a more timely manner |