-
Notifications
You must be signed in to change notification settings - Fork 18
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
docs: add general labels documentation for issues and PRs #342
base: master
Are you sure you want to change the base?
Conversation
cc: @expressjs/triagers |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
In general this is GREAT. I added a few nitpick comments but will just drop an approval since I think they are easy to resolve.
| -------------------- | ----------------------------------------------------------------------------------- | | ||
| `bug` | Denotes confirmed bugs. | | ||
| `duplicate` | A duplicate issue. | | ||
| `enhancement` | An issue requesting an enhancement. | |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| `enhancement` | An issue requesting an enhancement. | | |
| `enhancement` | An issue requesting or implementing an enhancement. | |
| `bug` | Denotes confirmed bugs. | | ||
| `duplicate` | A duplicate issue. | | ||
| `enhancement` | An issue requesting an enhancement. | | ||
| `help wanted` | Extra help may be needed to resolve this issue. | |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| `help wanted` | Extra help may be needed to resolve this issue. | | |
| `help wanted` | Help from the community is requested to assist in resolving this issue. | |
| `enhancement` | An issue requesting an enhancement. | | ||
| `help wanted` | Extra help may be needed to resolve this issue. | | ||
| `invalid` | This is not a proper issue report, request, or question. | | ||
| `question` | For issues where the issuer is asking something. | |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
We have been moving these into discussions, which IMO is better than using a label. Could we just remove this?
| `tests` | This issue pertains to the tests themselves. | | ||
| `deprecate` | Issue is about a feature that is pending future removal. | | ||
| `release` | A tracking issue for a specific release milestone. | | ||
| `ideas` | Marks an issue which is primarily an idea. | |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I am not sure how this is different from enhancement
, maybe we could consolidate into one or the other?
| `needs tests` | This pull request needs tests to be added. | | ||
| `needs docs` | This pull request needs documentation to be added. | | ||
| `needs rebase` | This pull request needs rebase to be added. | | ||
| `future` | An issue which should be resolved in a future release. | |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I would rather drop this in favor of specific semver major tags.
| `future` | An issue which should be resolved in a future release. | | ||
| `deps` | Marks a dependancy-related issue or pull request. | | ||
| `low priority` | Denotes a low-priority issue. | | ||
| `question` | Issues that look for answers. | |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This line is duplicated from line 12.
This was discussed in #294 about having the labels documented at the organizational level, so that new triagers know how to use them. Part of this was extracted from https://github.com/jshttp/style-guide?tab=readme-ov-file#issue-label-use.