doc: Elaborate on issue triaging

This commit is contained in:
Anmol Sethi 2020-12-07 16:47:28 -05:00
parent 104b85398c
commit 30994a566f
No known key found for this signature in database
GPG Key ID: 8CEF1878FF10ADEB

View File

@ -1,17 +1,37 @@
# Triage
## Filter
Triaging code-server issues is done with the following issue filter:
```
is:open no:project sort:created-asc -label:blocked -label:upstream
is:issue is:open no:project sort:created-asc -label:blocked -label:upstream -label:waiting-for-info -label:extension-request
```
We cannot work on any `blocked` or `upstream` issues as those are best handled by the
VS Code team. However, in certain circumstances we may fix them only in code-server if
necessary.
This will show issues that:
The GitHub project where we manage all our actionable issues is at:
https://github.com/cdr/code-server/projects/1
1. Are open.
2. Have no assigned project.
3. Are not `blocked` or tagged for work by `upstream` (VS Code core team)
- If an upstream issue is detrimental to the code-server experience we may fix it in
our patch instead of waiting for the VS Code team to fix it.
- Someone should periodically go through these issues to see if they can be unblocked
though!
4. Are not in `waiting-for-info`.
5. Are not extension requests.
Finally, we use milestones to track what issues are planned/or were closed for what release.
https://github.com/cdr/code-server/milestones
## Process
1. If an issue is a question/discussion it should be converted into a GitHub discussion.
2. Next, give the issue the appropriate labels and feel free to create new ones if
necessary.
- There are no hard and set rules for labels. We don't have many so look through and
see how they've been used throughout the repository. They all also have descriptions.
3. If more information is required, please ask the submitter and tag as
`waiting-for-info` and wait.
4. Finally, the issue should be moved into the
[code-server](https://github.com/cdr/code-server/projects/1) project where we pick
out issues to fix and track their progress.
We also use [milestones](https://github.com/cdr/code-server/milestones) to track what
issues are planned/or were closed for what release.