Skip to content
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

Define triage role criteria and process #3523

Closed
Tracked by #3516
handrews opened this issue Jan 25, 2024 · 6 comments
Closed
Tracked by #3516

Define triage role criteria and process #3523

handrews opened this issue Jan 25, 2024 · 6 comments
Labels

Comments

@handrews
Copy link
Member

Once its own new membership is established, @OAI/tsc needs to define

  • The process for adding to @OAI/triage
  • The criteria for being considered for @OAI/triage
  • The scope of what @OAI/triage members can, should, and should not do

Various other current Process issues, particularly around defining issue closure criteria, are likely relevant.

@handrews
Copy link
Member Author

handrews commented Feb 1, 2024

After attempting to further classify the large number of "security" issues and talking with folks more knowledgeable about that space, I think we need to recruit a security person into the triage group. Out of all the issue areas, that's the one Im least comfortable attempting to organize.

@handrews
Copy link
Member Author

handrews commented Feb 6, 2024

One thing that the triage team (and by extension, the maintainers team) needs is the ability to transfer issues to other repos, specifically:

  • learn.openapis.org (most requests for examples, clarifications beyond what is necessary for the spec, more documentation in general, and probably also the "please help me with X" questions as they are most likely to be relevant to improving the learn site)
  • Toolling (sometimes people announce their tools in the spec repo)
  • Outreach (the occasional issue about community engagement rather than the spec itself)
  • sig-moonwalk (beacuse Moonwalk)
  • sig-workflows (hasn't really come up, but eventually someone will file something that belongs here
  • Overlay-Specification (should be sig-overlay? we have several overlay issues to move)
  • (probably all the other sig-* repos?)

Basically, I think triage folks should have the same permissions across all of the repos that might be better homes for issues people file on OAI/OpenAPI-Specification

@miqui
Copy link
Contributor

miqui commented Feb 7, 2024

@handrews - what about managing labels?

@handrews
Copy link
Member Author

handrews commented Feb 7, 2024

@miqui that's already enabled for the triage group.

@handrews
Copy link
Member Author

handrews commented May 6, 2024

Some thoughts on what you need to show that you understand in order to join the Triage group, some of which is still being worked out:

@lornajane
Copy link
Contributor

Added documentation on discussion, issue and label management to the contributing file, and a section on the triage role itself: https://github.com/OAI/OpenAPI-Specification/blob/main/CONTRIBUTING.md#triage

@github-project-automation github-project-automation bot moved this from Todo to Done in Contributor Guidance Dec 12, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
Status: Done
Development

No branches or pull requests

3 participants