Automatically make new issues part of your triage process.
The Needs Triage bot monitors newly created issues and automatically adds a label of your choice to them. This means that looking at new issues in your triage process can be as simple as filtering on a label.
The bot can be asked to wait a little while before it looks at a new issue and it can also be told to not assign the label when specific conditions are met. For example, when the issue is already assigned or if it already has specific labels.
Placing the following configuration in .devbots/needs-triage.yml in your repository will instruct the bot to wait for three minutes after a new issue appears and then add a needs-triage label.
enabled: true
label: "needs-triage"
delay: 3
The Needs Triage bot is configured by adding a .devbots/needs-triage.yml file to the repository where you installed the bot. This file is in the YAML format, and can contain the following configuration options:
enabled |
boolean | whether the bot is active or not |
label |
string | the label to add on new issues |
delay |
number | the number of minutes to wait before looking at a new issue |
skip_when_has_labels |
list of strings | do not add a triage label when the issue has any of these labels. Use * to match any label |
skip_when_has_assignee |
boolean | do not add a triage label when the issue is assigned |
skip_when_has_milestone |
boolean | do not add a triage label when the issue is part of a milestone |
Placing the following configuration in .devbots/needs-triage.yml will make the bot immediately add a needs-triage label to newly created issues.
enabled: true
label: "needs-triage"
Placing the following configuration in .devbots/needs-triage.yml will make the bot wait 5 minutes before the triage label is added.
enabled: true
label: "triage"
delay: 5
Placing the following configuration in .devbots/needs-triage.yml will make the bot wait 5 minutes before the triage label is added. The bot will not do anything if the issue has already been assigned to someone or if the issue has a p1, p2 or p3 label assigned.
enabled: true
label: "triage"
delay: 5
skip_when_has_assignee: true
skip_when_has_labels: ["p1", "p2", "p3"]