Under-documented “Maintainer” role

[parkr]

Is your feature request related to a problem?

Yes I don’t know how to use the new maintainer role. I checked the guides documentation and the blog post. I found one small mention of an Edit button but I manage many gems so I need a more scalable solution.

Describe the solution you'd like

Please document the maintainer role:

1. In the blog post, link to documentation added and provide a sample gem command for setting someone as a maintainer.
2. In the API guides, document how I can use the Owners APIs to set someone as a maintainer (either modify in-place or add with that permission).
3. In the Guides, provide gem commands for setting someone as a maintainer.

Describe alternatives you've considered

Use the UI to update the many gems I maintain with a bot to downgrade the bot to maintainer. Or, poke at the API to reverse engineer it.

Additional context

• blog post: https://blog.rubygems.org/2024/11/07/maintainer-role.html
• API guides: https://guides.rubygems.org/rubygems-org-api/
• command reference: https://guides.rubygems.org/command-reference/
• Previous request for documentation: Undocumented "Maintainer" role #5196