Merge pull request #1129 from cli/triage-docs

add docs about new triage rotation

docs/triage.md

@@ -0,0 +1,62 @@
+# Triage role
+
+As we get more issues and pull requests opened on the GitHub CLI, we've decided on a weekly rotation
+triage role. The initial expectation is that the person in the role for the week spends no more than
+1-2 hours a day on this work; we can refine that as needed.
+
+# Incoming issues
+
+just imagine a flowchart
+
+- can this be closed outright?
+  - e.g. spam/junk
+  - close without comment
+- do we not want to do it?
+  - e.g. have already discussed not wanting to do or duplicate issue
+  - comment acknowledging receipt
+  - close
+- do we want to do it?
+  - e.g. bugs or things we have discussed before
+  - comment acknowledging it
+  - label appropriately (examples include `enhancement` or `bug`)
+  - add to project TODO column if appropriate, otherwise just leave it labeled
+- is it intriguing but needs discussion?
+  - label `needs-design` if design input is needed, ping
+  - label `needs-investigation` if engineering research is required before action can be taken
+  - ping engineers if eng needed
+  - ping product if it's about future directions/roadamp/big changes
+- does it need more info from the issue author?
+  - ask the user for that
+  - add `needs-user-input` label
+- is it a user asking for help and you have all the info you need to help?
+  - try and help
+
+# Incoming PRs
+
+just imagine a flowchart
+
+- can it be closed outright?
+  - ie spam/junk
+- do we not want to do it?
+  - ie have already discussed not wanting to do, duplicate issue
+  - comment acknowledging receipt
+  - close
+- is it intriguing but needs discussion?
+  - request an issue
+  - close
+- is it something we want to include?
+  - add `community` label
+  - add to `needs review` column
+
+# Weekly PR audit
+
+In the interest of not letting our open PR list get out of hand (20+ total PRs _or_ multiple PRs
+over a few months old), try to audit open PRs each week with the goal of getting them merged and/or
+closed. It's likely too much work to deal with every PR, but even getting a few closer to done is
+helpful.
+
+For each PR, ask:
+
+- is this too stale? close with comment
+- is this really close but author is absent? push commits to finish, request review
+- is this waiting on triage? go through the PR triage flow