devguide icon indicating copy to clipboard operation
devguide copied to clipboard
verified publisher icon python

Triager log/How to become a triager

Open ezio-melotti opened this issue 3 years ago • 2 comments

Currently we have:

As far as I know, there is no equivalent to the developer log for triagers, and there is a section about becoming triagers.

I think we should:

  • [ ] Add a triager log (possibly generated by the file proposed in #848)
  • [ ] Add a link to the "becoming a core dev" page to the "becoming triager" section, or move both to the same page
  • [ ] Improve the documentation on how to become a triager, including steps such as
    • [ ] making an official announcement on Discourse
    • [ ] adding the new triager to the triagers team on GitHub
    • [ ] reclaiming the GitHub mannequin
    • [ ] join the Discord server
  • [ ] Add links between the developer/triager logs and the "becoming *" section and the other way around

ezio-melotti avatar May 03 '22 00:05 ezio-melotti

Another thing that should be documented (if it isn't already), is the "Python Triage Membership" requests found at https://github.com/python/core-workflow/issues/new/choose (e.g. https://github.com/python/core-workflow/issues/416).

Currently it's not obvious if these issues are requesting the addition to someone to the GitHub Triage team, or if it's a request to consider them as potential candidate. It is also not entirely clear who should act on these issues and what should be done.

As far as I understand:

  • the user has already been accepted as a triager by the team
  • the user must be invited to the python org (if he isn't already part of it)
  • the user must be invited to the python-triage team (this might automatically send an invite to join the org)
  • the mannequins for the user should be reclaimed after they join the org

I suggest to:

  • document in the devguide that a request should be submitted to the core-workflow repo
  • add a link to this new devguide in the issue template
  • automatically ping people that can invite users/add them to teams/reclaim mannequins
    • by adding a specific label that people can subscribe to
    • by mentioning a team that can do this in the template
    • by automatically assigning the issue to someone (like me)

ezio-melotti avatar May 04 '22 04:05 ezio-melotti

I just found out that there is a docs-triagers team too. Maybe they should also be included.

More info at https://discuss.python.org/t/documentation-triagers/13850

ezio-melotti avatar May 05 '22 06:05 ezio-melotti