Description
Since the list of GitHub team members is not public (for people outside of the GitHub org), it's helpful to have a canonical place where we display those team members publicly (e.g. #2814 (comment)).
We could create this list somewhere centrally and sync it regularly from the GitHub team memberships, but we already have something that almost works, since most repos already list the maintainers and approvers at the bottom of their README files.
I'd like to propose standardizing this section across all repos:
The most important part:
- Anchors for
#maintainers
,#approvers
,#triagers
(if any)
The less important part, that I propose doing at the same time (since I'll probably attempt to automate this):
- Have these anchors as L3 headings under an L2 "Contributing" heading
- Have them in this order: maintainers, approvers, triagers, emeritus maintainers, emeritus approvers, emeritus triagers
- Don't display the github team name (I think it's unnecessary, and just adds a bit of extra clutter)
- Include the line "For more information about the X role, see ..."
- Have an L3 heading at the end of this section "Thanks to all of our contributors!" with the contributor graph
You can see an example with all the suggestions here:
https://github.com/trask/opentelemetry-python/tree/contributing-section-updates#contributing