kubernetes
/
community
mirror of https://github.com/kubernetes/community.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Describe new labels in triage guidelines 

Recently we have added new labels to identify issues that are candidates for close.
These issues are typically the one which are not goint to close via a fix. Add
description in triage guidelines about when to use these labels.
Related PR is,
kubernetes/test-infra#7554
This commit is contained in:
Sahdev P. Zala 2018-04-16 17:41:19 -04:00
parent 64ac525c3c
commit 38124eed5b
1 changed files with 35 additions and 30 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

65
contributors/guide/issue-triage.md
View File

@ -39,12 +39,13 @@ and this document will cover the basic ones.
## Determine if it's a support request ## Determine if it's a support request
Sometimes users ask for support requests in issues; these are usually requests Sometimes users ask for support requests in issues; these are usually requests
from people who need help configuring some aspect of Kubernetes. These issues should be from people who need help configuring some aspect of Kubernetes. These issues
labeled with `kind/support`, directed to our support structures (see below) and then closed. Also, if the issue should be labeled with `kind/support`, directed to our support structures
is clearly abandoned or in the wrong place, it should be closed. Keep in mind that (see below) and then closed. Also, if the issue is clearly abandoned or in the
only issue reporter, assignees and component organization members can close issue. wrong place, it should be closed. Keep in mind that only issue reporter,
If you do not have such privilege, just comment your findings. Otherwise, first assignees and component organization members can close issue. If you do not
`/assign` issue to yourself and then `/close`. have such privilege, just comment your findings. Otherwise, first `/assign`
issue to yourself and then `/close`.
### Support Structures ### Support Structures
@ -104,20 +105,21 @@ comment.
## Validate if the issue is bug ## Validate if the issue is bug
Validate if the problem is a bug by reproducing it. If reproducible, move to the Validate if the problem is a bug by reproducing it. If reproducible, move to
next step of defining priority. You may need to contact the issue reporter in the next step of defining priority. You may need to contact the issue reporter
the following cases: in the following cases:
* Do a quick duplicate search to see if the issue has been reported already. If * Do a quick duplicate search to see if the issue has been reported already.
a duplicate is found, let the issue reporter know it by marking it duplicate. Label If a duplicate is found, let the issue reporter know it by marking it
such issues as `triage/duplicate`. duplicate. Label such issues as `triage/duplicate`.
* If you can not reproduce the issue, label it as a `triage/not-reproducible`. * If you can not reproduce the issue, label it as a `triage/not-reproducible`.
Contact the issue reporter with your findings and close the issue if both the parties Contact the issue reporter with your findings and close the issue if both the
agree that it could not be reproduced. parties agree that it could not be reproduced.
* If you need more information to further work on the issue, let the reporter know it * If you need more information to further work on the issue, let the reporter
by adding an issue comment followed by label `triage/needs-information`. know it by adding an issue comment followed by label
`triage/needs-information`.
In all cases, if you do not get a response in 20 days then close the issue with In all cases, if you do not get a response in 20 days then close the issue
an appropriate comment. with an appropriate comment.
## Define priority ## Define priority
@ -208,16 +210,19 @@ block the release on it. A few days before release, we will probably move all
that milestone in bulk. that milestone in bulk.
## Closing issues ## Closing issues
Issues that are identified as a support request, duplicate, not-reproducible or Issues that are identified as a support request, duplicate, not-reproducible
lacks enough information from reporter should be closed following guidelines explained or lacks enough information from reporter should be closed following guidelines
in this file. Also, any issues that can not be resolved because of any particular reason explained in this file. Also, any issues that can not be resolved because of
should be closed. These issues should have one or more of following self-readable any particular reason should be closed. These issues should have one or more
labels: of following self-readable labels:
* `kind/support` * `kind/support`: Indicates an issues is not a bug but a support request.
* `triage/duplicate` * `triage/duplicate`: Indicates an issue is a duplicate of other open issue.
* `triage/not-reproducible` * `triage/not-reproducible`: Indicates an issue can not be reproduced as
* `triage/needs-information` described.
* `triage/unresolved` * `triage/needs-information`: Indicates an issue needs more information in
order to work on it.
* `triage/unresolved`: Indicates an issue that can not be resolved.
A triage engineer should add these labels appropriately. Kubernetees GitHub Org members can A triage engineer should add these labels appropriately. Kubernetees GitHub
search issues per these labels to find ones that can be quickly closed. Org members can search [open issues per these labels](https://github.com/kubernetes/kubernetes/labels?utf8=%E2%9C%93&q=triage%2F+kind%2Fsupport+is%3Aopen) to find ones that can be
quickly closed.