Skip to content

docs: clarify how React on Rails compares to alternatives#2856

Merged
ihabadham merged 2 commits intomainfrom
jg-codex/docs-compare-matrix
Mar 28, 2026
Merged

docs: clarify how React on Rails compares to alternatives#2856
ihabadham merged 2 commits intomainfrom
jg-codex/docs-compare-matrix

Conversation

@justin808
Copy link
Copy Markdown
Member

@justin808 justin808 commented Mar 26, 2026

Summary

  • add a decision-oriented Rails + frontend comparison matrix to the README
  • reframe the alternatives guide around architectural fit, SSR/RSC story, and tradeoffs
  • add Next.js + Rails API and clarify that the Evil Martians starter kit fits under the Inertia option

Test plan

  • npx prettier --check README.md docs/oss/getting-started/comparison-with-alternatives.md .claude/napkin.md
  • bundle exec rubocop (reports pre-existing offenses on main in unrelated Ruby files; no Ruby files were changed in this PR)
  • pnpm run lint (could not run in this clean worktree because node_modules is not installed here)

Note

Low Risk
Low risk: documentation-only changes that add/reshape comparison guidance without affecting runtime code or APIs.

Overview
Adds a new decision-oriented “Rails + frontend stack” comparison matrix to the README, including guidance on when to choose OSS vs Pro.

Reworks docs/oss/getting-started/comparison-with-alternatives.md to focus on architectural fit (incremental-in-views vs full-page), SSR/RSC/streaming paths, and operational tradeoffs; adds a dedicated Next.js + Rails API section and clarifies the Evil Martians starter kit as an Inertia example, plus minor wording updates to SSR caveats.

Written by Cursor Bugbot for commit 7101f2d. This will update automatically on new commits. Configure here.

Summary by CodeRabbit

  • Documentation
    • Expanded Rails + Frontend Stack comparison, adding Next.js + Rails API and Hotwire/Turbo entries.
    • Reworked feature-comparison into a higher-level options table for clearer guidance.
    • Added a “Recommended default” advising React on Rails with an upgrade path to Pro for Node-based SSR, streaming SSR, RSC, and advanced SSR tooling.
    • Clarified Inertia and Vite trade-offs and updated the broader “Comparison with Alternatives” link.

@chatgpt-codex-connector
Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented Mar 26, 2026

Walkthrough

Documentation reorganized: README gained a "Choosing the Right Rails + Frontend Stack" section; the comparison guide was restructured into higher-level option comparisons, added "Next.js + Rails API", and updated recommendations and SSR descriptions.

Changes

Cohort / File(s) Summary
README documentation
README.md
Added "Choosing the Right Rails + Frontend Stack" section and comparison table; replaced prior Rails/Shakapacker comparison link with a broader "Comparison with Alternatives" link.
Stack comparison guide
docs/oss/getting-started/comparison-with-alternatives.md
Reworked feature-matrix into a higher-level option comparison table, added Next.js + Rails API and explicit Hotwire/Turbo row, clarified Inertia.js text and SSR trade-offs, and updated "Recommended Default" guidance (React on Rails → React on Rails Pro upgrade triggers expanded).

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

Poem

🐰 I hopped through lines of docs today,
I nudged the stacks to show the way,
Next.js joined the Rails parade,
Hotwire, Inertia, choices laid,
Hooray for clearer paths — now let's play! 🥕✨

🚥 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 accurately summarizes the main objective: clarifying how React on Rails compares to alternatives through updated comparison documentation.
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
  • Commit unit tests in branch jg-codex/docs-compare-matrix

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

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

@greptile-apps
Copy link
Copy Markdown

greptile-apps Bot commented Mar 26, 2026

Greptile Summary

This is a documentation-only PR that adds a decision-oriented comparison matrix to README.md and rewrites the comparison-with-alternatives.md guide to focus on architectural fit rather than a binary feature-flag table. It also introduces Next.js + Rails API as a named option, clarifies the Evil Martians Inertia starter kit as an Inertia example rather than a separate category, and sharpens the trade-off wording for Inertia SSR and Vite Ruby SSR.

Key changes:

  • README.md: New "Choosing the Right Rails + Frontend Stack" comparison table (7 options) with a "Recommended default" recommendation and updated link to the comparison doc.
  • comparison-with-alternatives.md: Feature matrix replaced with an architectural-fit table; new "Recommended Default" section; new "Next.js + Rails API" section; Evil Martians starter kit note added under Inertia; Vite Ruby trade-off wording updated from "No SSR" to "DIY/less turnkey" for accuracy.

All relative links (./docs/oss/getting-started/oss-vs-pro.md, ./oss-vs-pro.md) resolve to existing files. No Ruby or JavaScript files were changed.

Confidence Score: 5/5

Safe to merge — documentation-only changes with no code impact, accurate content, and all links verified.

Both changed files are Markdown documentation. Content is factually consistent with the rest of the repo (oss-vs-pro.md exists, relative links resolve, feature claims match the codebase). The architectural reframing is clear and well-reasoned. No broken links, no removed content that was load-bearing elsewhere, and no risk of regression.

No files require special attention.

Important Files Changed

Filename Overview
README.md Adds a decision-oriented 'Choosing the Right Rails + Frontend Stack' comparison table covering 7 options, and updates the comparison link; all content is accurate and relative links resolve correctly.
docs/oss/getting-started/comparison-with-alternatives.md Replaces the binary feature-flag matrix with an architectural-fit comparison table, adds a Recommended Default section, adds the Next.js + Rails API option, clarifies the Evil Martians starter kit as an Inertia example, and updates Inertia/Vite trade-off wording for accuracy; no broken links or factual errors found.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[Choosing a Rails + React stack] --> B{Want React at all?}
    B -- No --> C[Hotwire / Turbo\nHTML-over-the-wire]
    B -- Yes --> D{Keep Rails as main app?}
    D -- No --> E[Next.js + Rails API\nFrontend-led architecture]
    D -- Yes --> F{Integration style?}
    F -- Full-page SPA pages\nwith Rails controllers --> G[Inertia Rails + React\nNo separate JSON API]
    F -- React inside Rails views --> H{SSR / RSC needs?}
    F -- DIY / maximum flexibility --> I[Vite Ruby + React\nManual mounting]
    H -- No SSR, simpler integration --> J[react-rails\nBasic ExecJS SSR]
    H -- Built-in SSR\nor upgrade path --> K[React on Rails OSS\nExecJS SSR, view helpers]
    H -- Node SSR, streaming,\nRSC, high-traffic --> L[React on Rails Pro\nNode renderer, RSC, streaming]
    K -- Need advanced features? --> L
Loading

Reviews (1): Last reviewed commit: "docs: clarify how React on Rails compare..." | Re-trigger Greptile

@claude
Copy link
Copy Markdown
Contributor

claude Bot commented Mar 26, 2026

Review: docs: clarify how React on Rails compares to alternatives

Overall this is a solid, well-structured documentation improvement. The shift to an architectural/decision-oriented framing is more useful than a raw feature checkbox table, and adding the Next.js + Rails API section fills a real gap. A few things worth addressing before merging:

Issues

1. Relative links in README will break on the hosted docs site

The new "Recommended default" paragraph uses file-relative links (./docs/oss/getting-started/oss-vs-pro.md), but the rest of the README uses absolute https://reactonrails.com/docs/... URLs. File-relative paths work on GitHub.com but will resolve incorrectly (404) on the hosted docs site. See inline comment.

2. Next.js section links to App Router reference, not the homepage

[Next.js](https://nextjs.org/docs/app) drops users into the App Router API reference. Users unfamiliar with Next.js may find this confusing — the main homepage or docs landing page would be a better entry point. See inline comment.

3. Loss of specific feature-level comparison

The old table had scannable ✓/— entries for concrete capabilities (code splitting with SSR, SSR caching, hot module replacement, active maintenance status, etc.). The new table is better for architectural decision-making but loses the ability to quickly spot whether a specific feature exists. Consider whether a link to the detailed OSS vs Pro matrix is enough to fill this gap for users who arrive at the comparison page looking for feature-level answers — it may be worth keeping a concise feature grid alongside the new architectural table.

Minor observations

  • The react-rails row in the README table says "Less active modern React investment" — this is accurate but slightly different wording from the comparison doc's "Minimal" active maintenance. Consistent language across both tables would help.
  • "is the React-first benchmark" in the Next.js section intro reads slightly like marketing copy; something like "is the leading React meta-framework for App Router, RSC, and streaming" would be more neutral.

Comment thread README.md Outdated
Comment thread docs/oss/getting-started/comparison-with-alternatives.md
Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🧹 Nitpick comments (2)
README.md (1)

201-201: Optional copy polish at Line 201.

“deeper look” could be replaced with “detailed comparison” for slightly crisper phrasing.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.md` at line 201, Replace the phrase "deeper look" in the README
sentence starting with "See [Comparison with
Alternatives](https://reactonrails.com/docs/getting-started/comparison-with-alternatives/)"
with "detailed comparison" so the line reads using the crisper phrasing "See
[Comparison with Alternatives]... for a detailed comparison of Inertia, Vite
Ruby, react-rails, Next.js, and Hotwire."
docs/oss/getting-started/comparison-with-alternatives.md (1)

195-195: Consider tightening wording at Line 195.

“very carefully” is slightly vague; a sharper phrase (e.g., “with explicit boundary design”) reads more concretely.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/oss/getting-started/comparison-with-alternatives.md` at line 195,
Replace the vague phrase in the sentence "Duplicates routing, auth/session, and
deployment concerns across two layers unless designed very carefully" with a
concrete alternative; update that line (the sentence) to read something like
"Duplicates routing, auth/session, and deployment concerns across two layers
unless there are clearly defined boundaries and ownership" (or use "with
explicit boundary design") to make the guidance more specific.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Nitpick comments:
In `@docs/oss/getting-started/comparison-with-alternatives.md`:
- Line 195: Replace the vague phrase in the sentence "Duplicates routing,
auth/session, and deployment concerns across two layers unless designed very
carefully" with a concrete alternative; update that line (the sentence) to read
something like "Duplicates routing, auth/session, and deployment concerns across
two layers unless there are clearly defined boundaries and ownership" (or use
"with explicit boundary design") to make the guidance more specific.

In `@README.md`:
- Line 201: Replace the phrase "deeper look" in the README sentence starting
with "See [Comparison with
Alternatives](https://reactonrails.com/docs/getting-started/comparison-with-alternatives/)"
with "detailed comparison" so the line reads using the crisper phrasing "See
[Comparison with Alternatives]... for a detailed comparison of Inertia, Vite
Ruby, react-rails, Next.js, and Hotwire."

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 26357f62-f34c-4f5d-827f-c321f6df75bc

📥 Commits

Reviewing files that changed from the base of the PR and between aa9a002 and 7101f2d.

📒 Files selected for processing (2)
  • README.md
  • docs/oss/getting-started/comparison-with-alternatives.md

Match the dominant link style in the README by using absolute
reactonrails.com URLs instead of relative file paths.

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>
Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🧹 Nitpick comments (1)
README.md (1)

201-201: Optional: Consider alternative wording.

Static analysis suggests "deeper" might be strengthened with a different adjective (e.g., "detailed", "comprehensive", "thorough"). However, the current wording is perfectly acceptable.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.md` at line 201, Replace the adjective "deeper" in the sentence
beginning "See [Comparison with Alternatives]..." with a stronger alternative
such as "detailed", "comprehensive", or "thorough" (e.g., "See [Comparison with
Alternatives] for a detailed look...") to improve wording clarity; update the
single sentence in README.md where that phrase appears.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Nitpick comments:
In `@README.md`:
- Line 201: Replace the adjective "deeper" in the sentence beginning "See
[Comparison with Alternatives]..." with a stronger alternative such as
"detailed", "comprehensive", or "thorough" (e.g., "See [Comparison with
Alternatives] for a detailed look...") to improve wording clarity; update the
single sentence in README.md where that phrase appears.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: ba433610-d41d-4868-8948-6705d931d6c2

📥 Commits

Reviewing files that changed from the base of the PR and between 7101f2d and ad0738a.

📒 Files selected for processing (1)
  • README.md

@claude
Copy link
Copy Markdown
Contributor

claude Bot commented Mar 28, 2026

Review: docs: clarify how React on Rails compares to alternatives

The architectural reframing is a genuine improvement. Shifting from a raw feature-checkbox table to a decision-oriented matrix is more useful for developers evaluating stacks. The Next.js + Rails API section fills a real gap. A few issues worth addressing before merging:

Issues

1. Next.js link drops users into the App Router API reference

The Next.js link in the new section points to https://nextjs.org/docs/app (the App Router API reference), not the homepage or docs landing page. A developer unfamiliar with Next.js has no orientation there. Prefer https://nextjs.org or https://nextjs.org/docs. See inline comment.

2. Hotwire "Built-in SSR path" value is misleading

The Hotwire row entry for "Built-in SSR path" reads HTML-over-the-wire, which describes what Hotwire is, not whether it has an SSR path. Every other N/A in that column signals "this concept doesn't apply" — Hotwire is the only row where a description was substituted for N/A. This makes the column inconsistent to scan. See inline comment.

3. Loss of specific feature-level comparison

The old table had scannable entries for concrete capabilities: code splitting with SSR, SSR caching, HMR, auto-bundling, type-safe routing, and active maintenance status. The new table uses qualitative values ("Excellent", "Good", "DIY") that are more opinion-based. Users with a specific capability question ("does X support SSR caching?") can no longer get a quick answer. Worth considering whether a link to the OSS vs Pro matrix is enough of a bridge, or whether a compact feature grid should be kept alongside the new architectural table.

Minor

  • "is the React-first benchmark" in the Next.js section intro reads like marketing copy. More neutral: "is the leading React meta-framework for App Router, RSC, and streaming SSR."
  • react-rails row in README says "Less active modern React investment" while the detailed section says "in maintenance mode maintained by ShakaCode" — slightly different signals worth making consistent.

Comment thread docs/oss/getting-started/comparison-with-alternatives.md
Comment thread docs/oss/getting-started/comparison-with-alternatives.md
@ihabadham ihabadham merged commit 651076b into main Mar 28, 2026
20 checks passed
@ihabadham ihabadham deleted the jg-codex/docs-compare-matrix branch March 28, 2026 02:25
@justin808 justin808 mentioned this pull request Mar 28, 2026
2 tasks
justin808 added a commit that referenced this pull request Mar 28, 2026
## Summary

- Stamped `### [16.5.1] - 2026-03-27` with two Pro fixes (PRs #2872,
#2768)
- Removed the `### [16.5.0.rc.0]` section (was already released as
16.5.0 stable)
- Consolidated the 16.5.0 section with full entries (previously just
said "no changes from rc.0")
- Updated diff links at bottom of file

## Skipped PRs (docs/internal only)
#2856, #2860, #2857, #2859, #2864, #2870, #2863, #2868, #2827, #2862,
#2850, #2851, #2852, #2831, #2610, #2848

## Test plan
- [ ] Verify CHANGELOG.md formatting and diff links are correct
- [ ] Run `rake release` (no args) after merge to publish 16.5.1

🤖 Generated with [Claude Code](https://claude.com/claude-code)

<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> **Low Risk**
> Low risk: changes are limited to `CHANGELOG.md` release notes and
version/compare links with no runtime code modifications.
> 
> **Overview**
> Documents the `16.5.1` release by adding a new section under
*Unreleased* with two **[Pro]** fixes (missing packaged rake tasks and
avoiding duplicated bundles during remote renderer asset uploads).
> 
> Cleans up the `16.5.0` entry by removing the `16.5.0.rc.0` section and
updating the compare-link footer so `unreleased` now starts from
`v16.5.1` and `16.5.0` compares from `v16.4.0`.
> 
> <sup>Written by [Cursor
Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit
9a6b224. This will update automatically
on new commits. Configure
[here](https://cursor.com/dashboard?tab=bugbot).</sup>
<!-- /CURSOR_SUMMARY -->

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->

## Summary by CodeRabbit

* **Documentation**
* Updated changelog to document version 16.5.1 release with consolidated
version history and updated comparison links.

<!-- end of auto-generated comment: release notes by coderabbit.ai -->

Co-authored-by: Claude Opus 4.6 (1M context) <[email protected]>
justin808 added a commit that referenced this pull request Mar 28, 2026
…olve-2835

* origin/main:
  Bump version to 16.5.1
  Update CHANGELOG.md for 16.5.1 (#2873)
  fix: include lib/tasks/ in pro gem so rake tasks are available (#2872)
  docs: clarify how React on Rails compares to alternatives (#2856)
  docs: fix published setup guidance gaps (#2860)
  docs: refresh setup and runtime guidance (#2857)
  docs: refresh pro upgrade examples (#2859)
  docs: modernize dependency update commands (#2864)
  Update spec/dummy Gemfile.lock for async >= 2.29 (#2870)

# Conflicts:
#	CHANGELOG.md
justin808 added a commit that referenced this pull request Mar 28, 2026
…olve-2849

* origin/main:
  Bump version to 16.5.1
  Update CHANGELOG.md for 16.5.1 (#2873)
  fix: include lib/tasks/ in pro gem so rake tasks are available (#2872)
  docs: clarify how React on Rails compares to alternatives (#2856)
  docs: fix published setup guidance gaps (#2860)
  docs: refresh setup and runtime guidance (#2857)
  docs: refresh pro upgrade examples (#2859)
  docs: modernize dependency update commands (#2864)
  Update spec/dummy Gemfile.lock for async >= 2.29 (#2870)

# Conflicts:
#	CHANGELOG.md
justin808 added a commit that referenced this pull request Mar 28, 2026
…olve-2828

* origin/main:
  Bump version to 16.5.1
  Update CHANGELOG.md for 16.5.1 (#2873)
  fix: include lib/tasks/ in pro gem so rake tasks are available (#2872)
  docs: clarify how React on Rails compares to alternatives (#2856)
  docs: fix published setup guidance gaps (#2860)
  docs: refresh setup and runtime guidance (#2857)
  docs: refresh pro upgrade examples (#2859)
  docs: modernize dependency update commands (#2864)
  Update spec/dummy Gemfile.lock for async >= 2.29 (#2870)

# Conflicts:
#	CHANGELOG.md
justin808 added a commit that referenced this pull request Mar 28, 2026
…olve-2834

* origin/main:
  Bump version to 16.5.1
  Update CHANGELOG.md for 16.5.1 (#2873)
  fix: include lib/tasks/ in pro gem so rake tasks are available (#2872)
  docs: clarify how React on Rails compares to alternatives (#2856)
  docs: fix published setup guidance gaps (#2860)
  docs: refresh setup and runtime guidance (#2857)
  docs: refresh pro upgrade examples (#2859)
  docs: modernize dependency update commands (#2864)
  Update spec/dummy Gemfile.lock for async >= 2.29 (#2870)

# Conflicts:
#	CHANGELOG.md
justin808 added a commit that referenced this pull request Mar 28, 2026
…olve-2833

* origin/main:
  Bump version to 16.5.1
  Update CHANGELOG.md for 16.5.1 (#2873)
  fix: include lib/tasks/ in pro gem so rake tasks are available (#2872)
  docs: clarify how React on Rails compares to alternatives (#2856)
  docs: fix published setup guidance gaps (#2860)
  docs: refresh setup and runtime guidance (#2857)
  docs: refresh pro upgrade examples (#2859)
  docs: modernize dependency update commands (#2864)
  Update spec/dummy Gemfile.lock for async >= 2.29 (#2870)

# Conflicts:
#	CHANGELOG.md
justin808 added a commit that referenced this pull request Mar 28, 2026
…olve-2661

* origin/main:
  Clarify streaming narrative in RSC docs (#2813) (#2814)
  Bump version to 16.5.1
  Update CHANGELOG.md for 16.5.1 (#2873)
  fix: include lib/tasks/ in pro gem so rake tasks are available (#2872)
  docs: clarify how React on Rails compares to alternatives (#2856)
  docs: fix published setup guidance gaps (#2860)
  docs: refresh setup and runtime guidance (#2857)
  docs: refresh pro upgrade examples (#2859)
  docs: modernize dependency update commands (#2864)
  Update spec/dummy Gemfile.lock for async >= 2.29 (#2870)

# Conflicts:
#	docs/oss/migrating/rsc-data-fetching.md
justin808 added a commit that referenced this pull request Mar 28, 2026
Reframe the alternatives comparison from a feature checkbox to a
decision-oriented guide that helps readers pick the right stack.

- Add "Choosing the Right Rails + Frontend Stack" table to README with
  7 options (RoR, RoR Pro, Inertia, Vite Ruby, react-rails, Next.js, Hotwire)
- Replace the old feature-presence grid in comparison-with-alternatives.md
  with columns focused on architectural fit (Keep Rails? Incremental React?
  SSR path? Operational model? Best when?)
- Add Next.js + Rails API section with strengths/trade-offs
- Correct Vite Ruby SSR characterization from "no SSR" to "DIY/experimental"
- Mention Evil Martians Inertia starter kit as a polished Inertia example
- Use absolute reactonrails.com URLs in README for link consistency

All alternative tool claims verified against official documentation.

Co-Authored-By: Justin Gordon <[email protected]>
Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>
justin808 added a commit that referenced this pull request Mar 28, 2026
## Summary

- Stamped `### [16.5.1] - 2026-03-27` with two Pro fixes (PRs #2872,
#2768)
- Removed the `### [16.5.0.rc.0]` section (was already released as
16.5.0 stable)
- Consolidated the 16.5.0 section with full entries (previously just
said "no changes from rc.0")
- Updated diff links at bottom of file

## Skipped PRs (docs/internal only)
#2856, #2860, #2857, #2859, #2864, #2870, #2863, #2868, #2827, #2862,
#2850, #2851, #2852, #2831, #2610, #2848

## Test plan
- [ ] Verify CHANGELOG.md formatting and diff links are correct
- [ ] Run `rake release` (no args) after merge to publish 16.5.1

🤖 Generated with [Claude Code](https://claude.com/claude-code)

<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> **Low Risk**
> Low risk: changes are limited to `CHANGELOG.md` release notes and
version/compare links with no runtime code modifications.
> 
> **Overview**
> Documents the `16.5.1` release by adding a new section under
*Unreleased* with two **[Pro]** fixes (missing packaged rake tasks and
avoiding duplicated bundles during remote renderer asset uploads).
> 
> Cleans up the `16.5.0` entry by removing the `16.5.0.rc.0` section and
updating the compare-link footer so `unreleased` now starts from
`v16.5.1` and `16.5.0` compares from `v16.4.0`.
> 
> <sup>Written by [Cursor
Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit
9a6b224. This will update automatically
on new commits. Configure
[here](https://cursor.com/dashboard?tab=bugbot).</sup>
<!-- /CURSOR_SUMMARY -->

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->

## Summary by CodeRabbit

* **Documentation**
* Updated changelog to document version 16.5.1 release with consolidated
version history and updated comparison links.

<!-- end of auto-generated comment: release notes by coderabbit.ai -->

Co-authored-by: Claude Opus 4.6 (1M context) <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants