How the Gatsby core team labels issues
Issue labels are a tool in GitHub that are used to group issues into one or more categories.
Gatsby is a very active project with many new issues opened each day. Labeling issues helps by identifying:
- good issues for new contributors to work on
- reported and confirmed bugs
- feature requests
- duplicate issues
- issues that are stalled or blocked
- the status of an open issue
- the topic or subject matter of the issue
Anyone who’s a member of the Gatsby Maintainers team can label issues. At this time, that’s composed of Gatsby core team members who participate in first touch maintenance.
When a new issue is filed, our Gatsbot applies a
status: triage needed label to it. Triage is undertaken every workday by Gatsby Core Team members.
Triaging new issues involves identifying each issue’s type (such as feature request or bug report), topic (such as GraphQL or Gatsby Recipes), and status. These labels are then part of a broader issue management workflow undertaken by the rest of the Gatsby team.
The general steps to triaging an issue are:
- Read an issue
- Choose the labels that apply to that issue
- Include any helpful comments that guide the author toward the next steps they need to take
- That’s it - sit back and relax, maybe take a few moments to enjoy the satisfaction of a job well done
For a full list of labels, see Gatsby’s issue labels and their descriptions, particularly the