Preparing for release, 2.2.1.

Update release metadata and document safe database validation, release-commit CI, and just-in-time RubyGems OTP handling.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: dblock

CHANGELOG.md

@@ -1,8 +1,7 @@
 ### Changelog
 
-### 2.2.1 (Next)
+### 2.2.1 (2026/10/24)
 
-* Your contribution here.
 * [#182](https://github.com/slack-ruby/slack-ruby-bot-server/pull/182): Modernize CI with current actions, native database services, dependency caching, and explicit Ruby 4, Mongoid 9, Active Record 8.1, PostgreSQL 18, Grape 3/4, and JSON 2/3 coverage while retaining existing compatibility combinations - [@dblock](https://github.com/dblock), [@Copilot](https://github.com/apps/copilot-swe-agent).
 * [#181](https://github.com/slack-ruby/slack-ruby-bot-server/pull/181): Migrated Danger to `danger-pr-comment` workflow - [@dblock](https://github.com/dblock).
 * [#180](https://github.com/slack-ruby/slack-ruby-bot-server/pull/180): Add support for Grape v3 - [@markokajzer](https://github.com/markokajzer).

README.md

@@ -37,7 +37,7 @@ A library that contains a web server and a RESTful [Grape](http://github.com/rub
 
 ## Stable Release
 
-You're reading the documentation for the **next** release of slack-ruby-bot-server. Please see the documentation for the [last stable release, v2.2.0](https://github.com/slack-ruby/slack-ruby-bot-server/blob/v2.2.0/README.md) unless you're integrating with HEAD. See [UPGRADING](UPGRADING.md) when upgrading from an older version. See [MIGRATING](MIGRATING.md) for help with migrating Legacy Slack Apps to Granular Scopes.
+You're reading the documentation for the **stable** release of slack-ruby-bot-server, 2.2.1. See [UPGRADING](UPGRADING.md) when upgrading from an older version. See [MIGRATING](MIGRATING.md) for help with migrating Legacy Slack Apps to Granular Scopes.
 
 ## Make Your Own
 

RELEASING.md

@@ -4,19 +4,25 @@ There're no hard rules about when to release slack-ruby-bot-server. Release bug
 
 ### Release
 
-Run tests, check that all tests succeed locally.
+Start from a clean, up-to-date canonical checkout on `master`. Confirm that the version in `lib/slack-ruby-bot-server/version.rb` matches the next changelog heading and has not already been published on RubyGems or tagged in Git.
 
-```
+Run the tests against dedicated local test databases as described in [CONTRIBUTING.md](CONTRIBUTING.md). Set the adapter and version selectors before installing dependencies. For example, with Ruby 4 and MongoDB running locally:
+
+```sh
+export DATABASE_ADAPTER=mongoid MONGOID_VERSION='~> 9.1' GRAPE_VERSION='~> 4.0' JSON_VERSION='~> 3.0'
+export DATABASE_URL=mongodb://localhost/slack_ruby_bot_server_test
 bundle install
-rake
+bundle exec rake
 ```
 
-Check that the last build succeeded in [Github Actions](https://github.com/slack-ruby/slack-ruby-bot-server/actions) for all supported platforms.
+Also validate the Active Record adapter with its own test database. Do not run adapter suites concurrently on one host; browser tests share port 9293. Never use a production database.
+
+Check that [GitHub Actions](https://github.com/slack-ruby/slack-ruby-bot-server/actions) succeeded for the release commit across both database matrices and RuboCop. A successful build for a different commit is not sufficient.
 
 Change "Next" in [CHANGELOG.md](CHANGELOG.md) to the current date.
 
 ```
-### 2.0.1 (2023/02/20)
+### 2.2.1 (2026/10/24)
 ```
 
 Remove the line with "Your contribution here.", since there will be no more contributions to this release.
@@ -26,34 +32,36 @@ Change `**next**` in the "Stable Release" section in README that warns users tha
 ```
 ## Stable Release
 
-You're reading the documentation for the **stable** release of slack-ruby-bot-server, 2.0.1. See [UPGRADING](UPGRADING.md) when upgrading from an older version.
+You're reading the documentation for the **stable** release of slack-ruby-bot-server, 2.2.1. See [UPGRADING](UPGRADING.md) when upgrading from an older version. See [MIGRATING](MIGRATING.md) for help with migrating Legacy Slack Apps to Granular Scopes.
 ```
 
 Commit your changes.
 
 ```
-git add README.md CHANGELOG.md
-git commit -m "Preparing for release, 2.0.1."
+git add README.md CHANGELOG.md RELEASING.md
+git commit -m "Preparing for release, 2.2.1."
 git push origin master
 ```
 
-Release.
+Wait for the release commit's GitHub Actions checks to succeed before publishing.
 
-```
-$ rake release
+RubyGems publishing requires a maintainer's credentials and may require a fresh one-time password (OTP). For an agent-assisted release, ask the maintainer for the OTP immediately before publishing, after tests, commits, and CI are complete. Use it only for the publishing process; never put OTPs or API keys in committed files, release notes, or logs.
+
+Pass the temporary code through `GEM_HOST_OTP_CODE`. With `OTP` holding the freshly supplied code:
 
-slack-ruby-bot-server 2.0.1 built to pkg/slack-ruby-bot-server-2.0.1.gem.
-Tagged v2.0.1.
-Pushed git commits and tags.
-Pushed slack-ruby-bot-server 2.0.1 to rubygems.org.
+```sh
+GEM_HOST_OTP_CODE="$OTP" bundle exec rake release
+unset OTP
 ```
 
+The release task builds the gem in `pkg/`, tags the release, pushes commits and the tag, and publishes to RubyGems. Confirm that the remote tag points to the release commit and that RubyGems lists the expected version before proceeding. If publishing fails, inspect which steps completed before retrying; do not move an existing release tag or overwrite a published version.
+
 ### Prepare for the Next Version
 
 Add the next release to [CHANGELOG.md](CHANGELOG.md).
 
 ```
-### 2.0.2 (Next)
+### 2.2.2 (Next)
 
 * Your contribution here.
 ```
@@ -65,13 +73,13 @@ Undo your change in README about the stable release.
 ```
 ## Stable Release
 
-You're reading the documentation for the **next** release of slack-ruby-bot-server. Please see the documentation for the [last stable release, v2.0.1](https://github.com/slack-ruby/slack-ruby-bot-server/blob/v2.0.1/README.md) unless you're integrating with HEAD. See [UPGRADING](UPGRADING.md) when upgrading from an older version. See [MIGRATING](MIGRATING.md) for help with migrating Legacy Slack Apps to Granular Scopes.
+You're reading the documentation for the **next** release of slack-ruby-bot-server. Please see the documentation for the [last stable release, v2.2.1](https://github.com/slack-ruby/slack-ruby-bot-server/blob/v2.2.1/README.md) unless you're integrating with HEAD. See [UPGRADING](UPGRADING.md) when upgrading from an older version. See [MIGRATING](MIGRATING.md) for help with migrating Legacy Slack Apps to Granular Scopes.
 ```
 
 Commit your changes.
 
 ```
 git add README.md CHANGELOG.md lib/slack-ruby-bot-server/version.rb
-git commit -m "Preparing for next development iteration, 2.0.2."
+git commit -m "Preparing for next development iteration, 2.2.2."
 git push origin master
 ```