Improve release rake task and documentation

[justin808]

Summary

• Add gem-release to Gemfile development dependencies (no longer requires manual gem install)
• Simplify version bump command logic (remove redundant case/if)
• Fix version constant loading (use only load, not require_relative followed by load)
• Improve OTP retry message to be clearer about when OTP might be needed
• Update CONTRIBUTING.md with proper release workflow (changelog before release)
• Add bundle exec prefix to release commands in documentation

Test plan

• RuboCop passes (42 files, no offenses)
• RSpec passes (40 examples, 0 failures)
• Verify release task still works (dry run: bundle exec rake release[patch,true])

🤖 Generated with Claude Code

Summary by CodeRabbit

• Documentation

  • Revised contributor release documentation with updated step-by-step instructions for executing releases and managing changelog updates.

• Chores

  • Added development dependency to standardize and enhance the release workflow.
  • Simplified release task implementation while improving authentication error messaging and user guidance.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[coderabbitai]

Walkthrough

The PR refactors the release workflow by adding gem-release as a development dependency and updating the release rake task to simplify bump logic, improve prompts, and reorder output instructions. Documentation is updated to reflect the new execution pattern using bundle exec.

Changes

Cohort / File(s)	Summary
Documentation & Configuration CONTRIBUTING.md, Gemfile	Updates release instructions to use bundle exec rake release pattern; adds pre-release CHANGELOG.md update steps. Adds gem-release ~> 2.2 as development dependency.
Release Task Implementation rakelib/release.rake	Simplifies bump logic by removing intermediate bump_type computation; switches to direct gem bump invocation. Updates OTP prompt to conditional hint. Replaces version file loading with direct UberTask::VERSION access. Reorders final output steps and removes CHANGELOG.md update instruction from task output.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~8 minutes

Possibly related PRs

• Add CONTRIBUTING.md, enhanced CHANGELOG.md, and release rake task #24: Directly related PR that introduces the initial release workflow, which this PR refines by updating release task logic, adding gem-release dependency, and adjusting CONTRIBUTING.md instructions.

Suggested reviewers

• borela

Poem

🐰 A cleaner release, with bundled grace,
No bump types needed in this race,
The gem-release gem joins the fold,
Simplified steps, a workflow bold,
Hop-hop-hooray, let versions roll! 🎉

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title 'Improve release rake task and documentation' accurately reflects the main changes in the changeset, which include improvements to the release rake task (simplifying version bump logic, fixing version loading, updating task description) and documentation updates (CONTRIBUTING.md with changelog and bundle exec instructions).
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch jg/release-rake-improvements

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}