Skip to content

Describe new labels in triage guidelines#1970

Merged
k8s-ci-robot merged 2 commits into
kubernetes:masterfrom
spzala:triagelabels
Apr 19, 2018
Merged

Describe new labels in triage guidelines#1970
k8s-ci-robot merged 2 commits into
kubernetes:masterfrom
spzala:triagelabels

Conversation

@spzala

@spzala spzala commented Mar 26, 2018

Copy link
Copy Markdown
Member

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#7200

@k8s-ci-robot k8s-ci-robot added size/M Denotes a PR that changes 30-99 lines, ignoring generated files. cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. labels Mar 26, 2018
@k8s-github-robot k8s-github-robot added area/contributor-guide Issues or PRs related to the contributor guide sig/contributor-experience Categorizes an issue or PR as relevant to SIG Contributor Experience. labels Mar 26, 2018
@spzala

spzala commented Mar 26, 2018

Copy link
Copy Markdown
Member Author

/cc @spiffxp @parispittman @grodrigues3

@cblecker

Copy link
Copy Markdown
Member

/hold
We don't have commands for these new labels yet.

@k8s-ci-robot k8s-ci-robot added the do-not-merge/hold Indicates that a PR should not merge because someone has issued a /hold command. label Mar 26, 2018
@spzala

spzala commented Mar 26, 2018

Copy link
Copy Markdown
Member Author

@cblecker thanks and I am good with hold but I thought we can use labels as such too i.e. use in combination with /close command. Org members can use these label followed by /close command to actually close the issue. Non-org members can not use close (or related) command but they can at least label trivial issues with their findings, and org member can close those issues quickly.
Again, I am totally good to wait on it but this is how one of the usages I thought. Thanks!!

@cblecker

Copy link
Copy Markdown
Member

@spzala The only way to apply these labels is to have write access to the repo. There is no prow command to add them.

We need to figure out the flow, and what we are trying to do. Are we trying to allow anyone to triage issues? Do we know if we have incentives for non-org members to triage issues? Or are these labels to track statistics on issues (how many duplicates, etc)

There's some confusion about the process, and we need to get it cleared up.

@spzala

spzala commented Mar 26, 2018

Copy link
Copy Markdown
Member Author

@cblecker thanks, and good questions. Based on PR, kubernetes/test-infra#7200, I thought these labels can be applied now. I was traveling lately so unfortunately didn't get to use them yet. So below:
Are we trying to allow anyone to triage issues?

yes, we want to encourage anyone to look at open issues and triage. I am saying this based on the discussion when Jorge and I worked on creating triage guidelines.

Do we know if we have incentives for non-org members to triage issues?

I don't think that we have any incentives for non-org members and that's the one of the thoughts with these labels that it will help towards finding non-org members triage work.

Or are these labels to track statistics on issues (how many duplicates, etc)

yes, exactly, that's one of the usages we had in mind and we explained in the initial google doc that we can display such statistics on devstat.

Thanks!!

@jberkus

jberkus commented Apr 4, 2018

Copy link
Copy Markdown
Contributor

Why is kind-support a kind, and not a close?

@spzala

spzala commented Apr 4, 2018

Copy link
Copy Markdown
Member Author

@jberkus yup good point, we considered that in the proposal with either new labels have kind or close prefix..the consensus was to go with close which definitely made more sense considering the label types. As I work with @spiffxp on changing close to triage (or related) prefix, I will discuss the legacy kind/support naming with him as it's been used for triage. Thanks!

@cblecker

cblecker commented Apr 4, 2018

Copy link
Copy Markdown
Member

Yeah, I would support a more broad "triage/*" series of labels.. like "triage/duplicate" or "triage/support-request"

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

@cblecker cblecker left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This works for me, although it might be advisable to point them to the /triage command somewhere, or provide examples.

Comment thread contributors/guide/issue-triage.md Outdated
is clearly abandoned or in the wrong place, it should be closed. Keep in mind that
only issue reporter, assignees and component organization members can close issue.
from people who need help configuring some aspect of Kubernetes. These issues should be
labeled with `kind/support`, directed to our support structures (see below) and then closed. Also, if the issue

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: this doc is wrapped at 80 chars, but this line exceeds.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks, will fix it!

Comment thread contributors/guide/issue-triage.md Outdated
* `triage/duplicate`
* `triage/not-reproducible`
* `triage/needs-information`
* `triage/unresolved`

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't see anything describing the use for this label

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sure I will add brief explanation here.

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
@cblecker

Copy link
Copy Markdown
Member

/lgtm
/approve

@spzala Feel free to remove hold when you're ready for this to merge. I don't know if anyone else wants to review this as well.

@k8s-ci-robot k8s-ci-robot added the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Apr 19, 2018
@k8s-ci-robot

Copy link
Copy Markdown
Contributor

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: cblecker

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@k8s-ci-robot k8s-ci-robot added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Apr 19, 2018
@spzala

spzala commented Apr 19, 2018

Copy link
Copy Markdown
Member Author

@cblecker thanks!! The PR been open for review for some time now and we have discussed it in the ContribEx meeting so I am feeling safe to merge it. Also once it merge I can send email to ML about these changes we made from close/* to triage/* as we discussed earlier and can also use it at KubeCon if we end up having triage session at contributor summit.

@spzala

spzala commented Apr 19, 2018

Copy link
Copy Markdown
Member Author

/hold cancel

@k8s-ci-robot k8s-ci-robot removed the do-not-merge/hold Indicates that a PR should not merge because someone has issued a /hold command. label Apr 19, 2018
@k8s-ci-robot k8s-ci-robot merged commit 668e18c into kubernetes:master Apr 19, 2018
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

approved Indicates a PR has been approved by an approver from all required OWNERS files. area/contributor-guide Issues or PRs related to the contributor guide cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. lgtm "Looks good to me", indicates that a PR is ready to be merged. sig/contributor-experience Categorizes an issue or PR as relevant to SIG Contributor Experience. size/M Denotes a PR that changes 30-99 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants