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

[parkr]

Hey @colby-swandale! I hope the launch of the new role system is going well. I would love to use it but do so programmatically via the API or via the gem command. Any way we could have documentation for doing that or an understanding of when it will ship to these platforms? Thanks!