Merge branch 'jdsalaro-docs-development-gems-rubygemsorg-management-considerations' into 'master'

Improve development docs regarding managing RubyGems.org footprint

See merge request https://gitlab.com/gitlab-org/gitlab/-/merge_requests/144768



Merged-by: Ahmed Hemdan <ahemdan@gitlab.com>
Approved-by: Philippe Lafoucrière <30915-plafoucriere@users.noreply.gitlab.com>
Reviewed-by: Philippe Lafoucrière <30915-plafoucriere@users.noreply.gitlab.com>
Reviewed-by: Rémy Coutable <remy@rymai.me>
Reviewed-by: Ahmed Hemdan <ahemdan@gitlab.com>
Co-authored-by: Philippe Lafoucrière <30915-plafoucriere@users.noreply.gitlab.com>
Co-authored-by: Rémy Coutable <remy@rymai.me>
Co-authored-by: Jayson Salazar Rodriguez <mail@jdsalaro.com>

doc/development/gems.md

@@ -348,12 +348,22 @@ to store them in monorepo:
   - Those Gems will not be published by us to RubyGems.
   - Those Gems will be referenced via `path:` in `Gemfile`, since we cannot depend on RubyGems.
 
-## Reserve a gem name
+## Considerations regarding rubygems.org
 
-We reserve a gem name as a precaution **before publishing any public code that contains a new gem**, to avoid name-squatters taking over the name in RubyGems.
+### Reserve a gem name
+
+We may reserve gem names as a precaution **before publishing any public code that contains a new gem**, to avoid name-squatters taking over the name in RubyGems.
 
 To reserve a gem name, follow the steps to [Create and publish a Ruby gem](#create-and-publish-a-ruby-gem), with the following changes:
 
 - Use `0.0.0` as the version.
 - Include a single file `lib/NAME.rb` with the content `raise "Reserved for GitLab"`.
 - Perform the `build` and `publish`, and check <https://rubygems.org/gems/> to confirm it succeeded.
+
+### Account creation
+
+In case you are considering the creation of an account on RubyGems.org for the purpose of your work at GitLab, make sure to use your corporate email account.
+
+### Maintainer and Account Changes
+
+All changes such as modifications to account emails or passwords, gem owners, and gem deletion ought to be communicated previously to the directly responsible teams, through issues or Slack (the team's Slack channel, `#rubygems`, `#ruby`, `#development`).