Skip to content

docs: add Example Migrations page (#3125)#3197

Merged
justin808 merged 5 commits intomainfrom
jg/fix-3125
Apr 23, 2026
Merged

docs: add Example Migrations page (#3125)#3197
justin808 merged 5 commits intomainfrom
jg/fix-3125

Conversation

@justin808
Copy link
Copy Markdown
Member

@justin808 justin808 commented Apr 23, 2026

Summary

Adds a dedicated Example Migrations page (docs/oss/migrating/example-migrations.md) that consolidates migration references for teams coming from react-rails, vite_rails, or a custom Rails/React bridge, and describes what counts as proof (performance or maintainability). The react-rails and vite_rails migration guides, docs/README.md, and the Migration Guides sidebar now link to it. Also picks up routine Gemfile.lock updates in react_on_rails_pro and react_on_rails_pro/spec/dummy.

Refs #3125

Pull Request checklist

  • [ ] Add/update test to cover these changes (docs-only)
  • Update documentation
  • [ ] Update CHANGELOG file (docs-only, no user-facing code change)

Other Information

The page intentionally points the in-progress migration PR list at the #3125 meta issue so the docs stay focused on durable references.


Note

Low Risk
Docs-only updates that adjust migration guide cross-links and navigation; no runtime or API behavior changes.

Overview
Improves migration documentation cross-references by clarifying that other migration paths are in the Migration Guides sidebar and by explicitly listing additional guides (Rails 5 API-only, AngularJS) plus a separate sidebar location for React Server Components content.

Updates the react-rails migration guide to point readers to Example Migrations for published references and to the #3125 meta issue for in-progress migration PR tracking.

Reviewed by Cursor Bugbot for commit 01841df. Bugbot is set up for automated code reviews on this repo. Configure here.

Summary by CodeRabbit

  • Documentation
    • Reworked migration examples into a unified bulleted list for clearer navigation
    • Added explicit migration entries for Rails 5 API‑only and AngularJS, preserved Webpack→Rspack and Babel→SWC links
    • Clarified where React Server Components content appears in the sidebar
    • Added a pointer to a meta tracking issue for ongoing migration PRs

Adds a dedicated Example Migrations page that consolidates migration references
for teams coming from react-rails, vite_rails, or custom Rails/React bridges.
Links from the react-rails and vite_rails migration guides, the docs README,
and the Migration Guides sidebar. Also picks up routine Gemfile.lock updates
in react_on_rails_pro.

Refs #3125

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented Apr 23, 2026

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

  • @coderabbitai resume to resume automatic reviews.
  • @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

  • ▶️ Resume reviews
  • 🔍 Trigger review

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: f8429c29-e6b6-4e6e-b854-055fba8d8465

📥 Commits

Reviewing files that changed from the base of the PR and between 905457b and 01841df.

📒 Files selected for processing (2)
  • docs/oss/migrating/example-migrations.md
  • docs/oss/migrating/migrating-from-react-rails.md
✅ Files skipped from review due to trivial changes (1)
  • docs/oss/migrating/migrating-from-react-rails.md
🚧 Files skipped from review as they are similar to previous changes (1)
  • docs/oss/migrating/example-migrations.md

Walkthrough

Reworks the "Other migration paths" section in example-migrations.md from a numbered list to a bulleted list, adds explicit entries for Rails 5 API-only and AngularJS, updates the RSC pointer to reference React on Rails Pro sidebar content, and appends a tracking meta-issue link (#3125) in migrating-from-react-rails.md.

Changes

Cohort / File(s) Summary
Migration examples doc
docs/oss/migrating/example-migrations.md
Converted "Other migration paths" from a numbered list to bullets; added Rails 5 API-only and AngularJS links; updated RSC callout to indicate RSC content is under React on Rails Pro in the sidebar; preserved Webpack→Rspack and Babel→SWC entries.
Cross-reference update
docs/oss/migrating/migrating-from-react-rails.md
Changed link text from “published repo examples” to “published migration references” and added a sentence pointing to meta tracking issue #3125 for in-progress migration PRs.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

Poem

🐇 I hopped the docs to tidy the trails,
Bullets arranged like carrot-stacked rails,
Rails, Angular, RSC now lined in a row,
A quick little hop — and onward I go! 🥕✨

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The PR title 'docs: add Example Migrations page (#3125)' accurately reflects the main change: adding a new documentation page for example migrations.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ 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/fix-3125

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 Apr 23, 2026

Greptile Summary

This PR adds a new docs/oss/migrating/example-migrations.md page that consolidates real-world migration references for teams coming from react-rails, vite_rails, or a custom Rails/React bridge, and wires it into docs/README.md, the two existing migration guides, and the sidebar. The Gemfile.lock files in react_on_rails_pro and its dummy app receive a routine term-ansicolor 1.10.2 → 1.11.3 upgrade that drops several now-unused transitive dependencies (mize, protocol, ruby_parser, sexp_processor).

Confidence Score: 5/5

Safe to merge — docs-only additions with a clean, routine Gemfile.lock update.

All changes are documentation additions/cross-links and a dependency-cleanup lockfile bump. No logic, API surface, or runtime behavior is affected. No P0 or P1 findings.

No files require special attention.

Important Files Changed

Filename Overview
docs/oss/migrating/example-migrations.md New page consolidating real-world migration references across react-rails, vite_rails, and custom bridge paths; well-structured with clear proof criteria.
docs/README.md Splits the old single "examples and migration" link into separate "Example migrations" (new doc page) and "Examples gallery" entries; removes direct repo link now covered by the new page.
docs/oss/migrating/migrating-from-react-rails.md Top-level heading corrected from H2 to H1; adds "Choose a first slice" section and cross-links to example-migrations page.
docs/oss/migrating/migrating-from-vite-rails.md Adds maintainability-first guidance for hybrid vite_rails + custom wrapper apps and cross-links to example-migrations page.
docs/sidebars.ts Inserts migrating/example-migrations as the first item in the Migration Guides sidebar category.
react_on_rails_pro/Gemfile.lock Routine lockfile update: upgrades term-ansicolor 1.10.2→1.11.3 and removes its old dependency chain (mize, protocol, ruby_parser, sexp_processor); adds arm64-darwin-23 platform.
react_on_rails_pro/spec/dummy/Gemfile.lock Same term-ansicolor upgrade and dependency cleanup as the parent Gemfile.lock.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    README["docs/README.md\n(Evaluating options)"] --> EM["example-migrations.md\n(new)"]
    README --> EG["reactonrails.com/examples\n(Examples gallery)"]
    EM --> RR["migrating-from-react-rails.md"]
    EM --> VR["migrating-from-vite-rails.md"]
    RR --> EM
    VR --> EM
    SIDEBAR["docs/sidebars.ts\nMigration Guides"] --> EM
    SIDEBAR --> RR
    SIDEBAR --> VR
    EM --> ISSUE["GitHub Issue #3125\n(in-progress PRs tracker)"]
Loading

Reviews (1): Last reviewed commit: "docs: add Example Migrations page for is..." | Re-trigger Greptile

@claude
Copy link
Copy Markdown
Contributor

claude Bot commented Apr 23, 2026

Code Review

Summary: Adds a new docs/oss/migrating/example-migrations.md page that consolidates migration references, wires it into the sidebar and existing guides, and picks up routine Gemfile.lock dependency updates.


Strengths

  • The new page is well-structured: clear separation between stable public references and in-progress work (tracked in the meta issue), plus explicit guidance on what counts as acceptable proof.
  • Cross-linking is consistent — both migrating-from-react-rails.md and migrating-from-vite-rails.md now point to the example page in two places each (intro callout + footer link).
  • Placing example-migrations first in the Migration Guides sidebar makes sense as a discovery entry point.
  • The Gemfile.lock cleanup (dropping mize, protocol, ruby_parser, sexp_processor as transitive deps of the term-ansicolor 1.10.2 → 1.11.3 bump) is clean.

Issues / Suggestions

1. Sidebar-only reference for additional migration paths (minor)

example-migrations.md mentions near the bottom:

Other migration paths (Webpack → Rspack, Babel → SWC, Rails 5 API-only, AngularJS, RSC) live in the Migration Guides sidebar.

Relying on sidebar discovery is weak for readers who land on the page directly (e.g. via a deep link or search). Consider turning these into direct links, as is already done for the react-rails and vite_rails entries just above.

2. Heading level fix in migrating-from-react-rails.md (good catch)

The title changed from ## to #, which is the correct H1 for a top-level doc page and is now consistent with migrating-from-vite-rails.md. No issue — confirming it is intentional.

3. arm64-darwin-23 added as a new Gemfile.lock platform

react_on_rails_pro/Gemfile.lock gains arm64-darwin-23 alongside the existing arm64-darwin-24 and arm64-darwin-25. This is likely from a contributor running bundle install on an older Mac. Harmless, but worth confirming it is deliberate rather than accidental churn.

4. Removed direct link from README (minor)

docs/README.md drops the direct link to react-on-rails-migration-example in the Evaluating section. That repo is still reachable via the new Example Migrations page, so the consolidation makes sense — just flagging in case any existing bookmarks or external links pointed at that specific README bullet.


Verdict

Low-risk, docs-only change. The main actionable item is item 1 (direct links vs. sidebar reference). Everything else is informational.

Comment thread docs/oss/migrating/example-migrations.md Outdated
Comment thread react_on_rails_pro/Gemfile.lock
… platform entry

- example-migrations.md: replace sidebar-only reference with explicit links to each migration path for readers arriving via direct link or search
- react_on_rails_pro/Gemfile.lock: remove accidental arm64-darwin-23 platform entry (docs-only PR churn)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@justin808
Copy link
Copy Markdown
Member Author

Thanks for the summary! Acknowledged — no action needed. For visibility: CodeRabbit flagged no actionable items.

@justin808
Copy link
Copy Markdown
Member Author

Thanks for the review! Acknowledged — no action needed since this is a non-actionable summary (5/5 confidence, safe to merge).

@justin808
Copy link
Copy Markdown
Member Author

Review Response Summary

I (Claude Code) addressed the review feedback in commit 496b4fa:

Addressed:

  • Explicit migration links (@claude[bot] inline + summary): Replaced the sidebar-only reference on docs/oss/migrating/example-migrations.md:120 with explicit markdown links to each migration path (Webpack → Rspack, Babel → SWC, Rails 5 API-only, AngularJS, RSC). Matches the style used for react-rails and vite_rails and helps readers arriving via direct link or search.
  • arm64-darwin-23 platform entry (@claude[bot] inline + summary): Removed from react_on_rails_pro/Gemfile.lock. This was accidental churn from a local bundle install, not intentional — this PR is docs-only.

Informational (no action needed):

  • Heading level fix in migrating-from-react-rails.md (###) is intentional and correct (makes it consistent with migrating-from-vite-rails.md).
  • Removed direct link from docs/README.md to react-on-rails-migration-example — that repo is still reachable via the new Example Migrations page, which is the intended consolidation.

Acknowledged (no action):

Both inline review threads resolved.

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented Apr 23, 2026

@justin808 Thanks for the detailed summary! The changes in commit 496b4fa14 look well-reasoned:

  • ✅ Explicit migration links in example-migrations.md — good call for readers arriving via direct link or search.
  • ✅ Removal of the accidental arm64-darwin-23 platform entry from Gemfile.lock keeps the PR focused as docs-only.
  • ✅ Heading level and link consolidation rationale are clear and intentional.

Let me know if you'd like me to do a fresh review of the updated changes!


🧠 Learnings used
Learnt from: justin808
Repo: shakacode/react_on_rails PR: 2651
File: docs/oss/introduction.md:47-47
Timestamp: 2026-03-26T02:20:12.940Z
Learning: In `docs/oss/introduction.md` (and related docs in the `shakacode/react_on_rails` repo), the link to `docs/oss/getting-started/comparison-with-alternatives.md` described as "a side-by-side matrix with benchmarks" is intentionally and accurately worded. The page includes actual benchmark sections (e.g., Vite vs Rspack benchmark tables), so the phrase "with benchmarks" should NOT be flagged as misleading in future reviews.

Learnt from: justin808
Repo: shakacode/react_on_rails PR: 2790
File: docs/oss/migrating/rsc-data-fetching.md:238-238
Timestamp: 2026-03-22T03:17:13.316Z
Learning: In `docs/oss/migrating/rsc-data-fetching.md` (React on Rails migration guide), the phrase "Rails fetches the data in the controller layer" is intentional and acceptable wording even when the ERB examples show inline ActiveRecord queries inside `stream_react_component`/`stream_react_component_with_async_props`. The inline queries are a teaching shortcut; "controller layer" is meant to convey that data fetching happens on the Rails side (not in React), not to mandate that queries must live in a controller action. Do not flag this phrasing as misleading in future reviews.

Learnt from: justin808
Repo: shakacode/react_on_rails PR: 2857
File: README.md:0-0
Timestamp: 2026-03-26T08:32:31.881Z
Learning: In `README.md` (and related docs) for `shakacode/react_on_rails`, the Ruby minimum version (`>= 3.0`) similarly reflects the actual package validator/gemspec floor, while `CI tested: 3.2 - 3.4` describes coverage. This distinction is intentional and should not be flagged as a docs/CI mismatch.

Learnt from: CR
Repo: shakacode/react_on_rails PR: 0
File: AGENTS.md:0-0
Timestamp: 2026-04-12T23:15:11.806Z
Learning: Applies to CHANGELOG.md : Changelog format: `[PR 1818](https://github.com/shakacode/react_on_rails/pull/1818) by [username](https://github.com/username)` (no hash before PR number)

Learnt from: alexeyr-ci2
Repo: shakacode/react_on_rails PR: 1732
File: spec/dummy/client/app-react16/startup/ReduxSharedStoreApp.client.jsx:40-44
Timestamp: 2025-04-26T21:55:55.874Z
Learning: In the react_on_rails project, files under `app-react16` directories are copied/moved to corresponding `/app` directories during the conversion process (removing the `-react16` suffix), which affects their relative import paths at runtime.
✅ Actions performed

Review triggered.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

@greptile-apps
Copy link
Copy Markdown

greptile-apps Bot commented Apr 23, 2026

Both changes in commit 496b4fa look correct:

  • example-migrations.md now has explicit links to all five migration paths (Webpack → Rspack, Babel → SWC, Rails 5 API-only, AngularJS, RSC) at the bottom, which is exactly the right pattern — matches the style used for react-rails and vite_rails above it.
  • react_on_rails_pro/Gemfile.lock no longer has the arm64-darwin-23 platform entry.

The explanations for the informational items (heading level, docs/README.md link removal) are sound. This PR is good to merge once the merge conflict is resolved.

Comment thread docs/oss/migrating/migrating-from-react-rails.md Outdated
Comment thread docs/oss/migrating/example-migrations.md
@claude
Copy link
Copy Markdown
Contributor

claude Bot commented Apr 23, 2026

Review: docs — Example Migrations page (#3125)

Overview

Docs-only PR. It improves the "Other migration paths" list in example-migrations.md (numbered list + prose → explicit bullet list with arrow labels) and adds a second callout in migrating-from-react-rails.md pointing back to that page.

What works well

  • Converting the implicit prose mention of Rails 5 API-only and AngularJS into explicit bullet-list links is a clear discoverability win.
  • Arrow notation () is a good convention for migration-direction labels.
  • The note that "Other migration paths live in the Migration Guides sidebar" gives readers a mental map of where to look next.

Issues

Duplicate link in migrating-from-react-rails.md (main concern, flagged inline)

The newly added sentence (line 141) and the pre-existing sentence immediately above it (line 139) both link to example-migrations.md. Two consecutive paragraphs that resolve to the same URL are confusing — a reader naturally assumes the second link goes somewhere different. I've left a suggestion inline to merge them into a single, combined sentence.

The phrase "active public PRs" in the new sentence is also subtly inaccurate: per example-migrations.md, in-progress PRs are tracked in the meta issue #3125, not on the example-migrations page itself.

RSC link label too terse (flagged inline)

The label was shortened from "Migrating to RSC" to just "RSC". In a list of otherwise spelled-out technology names this is fine, but RSC as a standalone label without expansion may not be immediately clear. A label like "React Server Components (RSC)" or "Migrate to RSC" would be more scannable.

Verdict

Good intent — the bullet list reformat is strictly better than before. Two small fixes (merge the duplicate link sentences, expand the RSC label) would make this ready to merge.

- migrating-from-react-rails.md: combine two consecutive sentences pointing to example-migrations.md and clarify that in-progress PRs live in meta issue #3125, not on the example-migrations page.
- example-migrations.md: expand the terse "RSC" link label to "React Server Components (RSC)" for consistency with sibling entries.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@justin808
Copy link
Copy Markdown
Member Author

Review Response Summary (round 2)

I (Claude Code) addressed the new round of inline review feedback in commit 905457b:

Addressed:

  • Duplicate link in migrating-from-react-rails.md (@claude[bot]): Merged the two consecutive sentences pointing to example-migrations.md into one. Also clarified that in-progress migration PRs are tracked in meta issue #3125, not on the example-migrations page (the previous "active public PRs" wording was misleading).
  • Terse RSC link label in example-migrations.md (@claude[bot]): Expanded to React Server Components (RSC) to match the descriptive style of the other entries (Webpack → Rspack, Babel → SWC, Rails 5 API-only, AngularJS).

Acknowledged (no action):

  • @claude[bot] full review summary (4301301259): covered the same two inline items above; both are now resolved.
  • @coderabbitai[bot] / @greptile-apps[bot] follow-ups: confirmed the previous round was good to merge; no new actionable items.

Both new inline review threads resolved.

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented Apr 23, 2026

Tip

For best results, initiate chat on the files or code changes.

@justin808 Thanks for the thorough round 2 summary! Both fixes in commit 905457b27 look great:

  • Merged duplicate link in migrating-from-react-rails.md — the consolidated sentence with the correct #3125 reference is cleaner and avoids any confusion about where in-progress PRs are tracked.
  • Expanded RSC label to React Server Components (RSC) — consistent and descriptive style across all migration path entries now.

The PR looks good to merge! 🚀

(^_^)


🧠 Learnings used
Learnt from: justin808
Repo: shakacode/react_on_rails PR: 2651
File: docs/oss/introduction.md:47-47
Timestamp: 2026-03-26T02:20:12.940Z
Learning: In `docs/oss/introduction.md` (and related docs in the `shakacode/react_on_rails` repo), the link to `docs/oss/getting-started/comparison-with-alternatives.md` described as "a side-by-side matrix with benchmarks" is intentionally and accurately worded. The page includes actual benchmark sections (e.g., Vite vs Rspack benchmark tables), so the phrase "with benchmarks" should NOT be flagged as misleading in future reviews.

Learnt from: justin808
Repo: shakacode/react_on_rails PR: 2790
File: docs/oss/migrating/rsc-data-fetching.md:238-238
Timestamp: 2026-03-22T03:17:13.316Z
Learning: In `docs/oss/migrating/rsc-data-fetching.md` (React on Rails migration guide), the phrase "Rails fetches the data in the controller layer" is intentional and acceptable wording even when the ERB examples show inline ActiveRecord queries inside `stream_react_component`/`stream_react_component_with_async_props`. The inline queries are a teaching shortcut; "controller layer" is meant to convey that data fetching happens on the Rails side (not in React), not to mandate that queries must live in a controller action. Do not flag this phrasing as misleading in future reviews.

Learnt from: CR
Repo: shakacode/react_on_rails PR: 0
File: AGENTS.md:0-0
Timestamp: 2026-04-12T23:15:11.806Z
Learning: Applies to CHANGELOG.md : Changelog format: `[PR 1818](https://github.com/shakacode/react_on_rails/pull/1818) by [username](https://github.com/username)` (no hash before PR number)

Learnt from: CR
Repo: shakacode/react_on_rails PR: 0
File: AGENTS.md:0-0
Timestamp: 2026-03-21T08:53:17.309Z
Learning: For small, focused PRs (roughly 5 files or fewer with one clear purpose): use at most one AI reviewer for inline comments, batch review fixes into one follow-up push, and verify language/runtime/library claims locally before making code changes in response to AI review

@greptile-apps
Copy link
Copy Markdown

greptile-apps Bot commented Apr 23, 2026

Both fixes look clean in the latest commit:

  • example-migrations.md: React Server Components (RSC) now matches the descriptive style of the other entries in that list.
  • migrating-from-react-rails.md: The bottom paragraph consolidates the two separate Example Migrations references into one sentence, and correctly routes in-progress PRs to the Track example migrations from existing Rails + React apps #3125 meta issue rather than implying they live on the docs page.

No outstanding concerns. This PR is good to merge.

@claude
Copy link
Copy Markdown
Contributor

claude Bot commented Apr 23, 2026

Code Review

Overall: Clean, docs-only PR. The reorganization from scattered prose + numbered list to a unified bulleted list is a genuine readability improvement. All linked files exist. One factual inaccuracy worth fixing before merge.

What works well

  • Converting the split numbered-list + trailing prose into a single bulleted list is clearer for scanning
  • Adding direct links for Rails 5 API-only and AngularJS guides that were previously only vaguely referenced in prose
  • The updated sentence in migrating-from-react-rails.md correctly points readers at the meta issue for in-progress work (consistent with how example-migrations.md itself handles this)

Issue: RSC is not in the "Migration Guides" sidebar

The new list groups React Server Components (RSC) under the heading "Other migration paths live in the Migration Guides sidebar", but the RSC migration content is not in the Migration Guides sidebar. Per docs/sidebars.ts, it lives under:

React on Rails Pro → React Server Components → Migrating to RSC

The old prose was actually accurate here—it explicitly called RSC out separately from the sidebar. The new grouping implies users will find RSC in Migration Guides, which they won't.

Suggested fix: split the list or add a note:

Other migration paths live in the **Migration Guides** sidebar:

- [Webpack → Rspack](./migrating-from-webpack-to-rspack.md)
- [Babel → SWC](./babel-to-swc-migration.md)
- [Rails 5 API-only](./convert-rails-5-api-only-app.md)
- [AngularJS](./angular-js-integration-migration.md)

For React Server Components migration content, see [Migrating to RSC](./migrating-to-rsc.md) (under **React on Rails Pro** in the sidebar).

Minor nits

  • The arrows on the first two items but not the last three is a slight style inconsistency within the same list (not blocking)
  • The updated sentence in migrating-from-react-rails.md is noticeably longer than before; the phrasing "additional real-world references" is a bit vague

Comment thread docs/oss/migrating/example-migrations.md Outdated
@justin808
Copy link
Copy Markdown
Member Author

Addressed the remaining review-summary items from #3197 (comment) in commit 01841dfe2:

  • Split the RSC link out of the Migration Guides list and noted that it lives under React on Rails Pro in the sidebar.
  • Made the sibling migration labels consistent.
  • Shortened the migrating-from-react-rails.md cross-link sentence and removed the vague "additional real-world references" wording.

Skipped/reconciled rationale for the older comments: the earlier inline threads already had replies and were resolved; CodeRabbit and Greptile comments were status-only or merge-readiness summaries; the older Claude summaries duplicated items already handled in commits 496b4fa14 and 905457b27.

@justin808
Copy link
Copy Markdown
Member Author

justin808 commented Apr 23, 2026

Scan window: full PR history. No previous <!-- address-review-summary --> checkpoint existed when scanned at 2026-04-23T05:47:05Z.

Mattered

  • Addressed the RSC sidebar-location bug in docs/oss/migrating/example-migrations.md in commit 01841dfe2: RSC is no longer grouped under the Migration Guides sidebar list and is now called out as living under React on Rails Pro. Replied to and resolved thread PRRT_kwDOAnNnU85893Z5 / discussion_r3128014288.

Optional

  • Addressed the migration-label consistency nit by changing the sibling entries to consistent action labels.
  • Addressed the long/vague migrating-from-react-rails.md sentence by shortening it and removing the vague "additional real-world references" wording.

Skipped

  • Earlier inline threads 3127650946, 3127651370, 3127953313, and 3127953489 were already replied to and resolved before this pass.
  • CodeRabbit and Greptile comments were status-only or merge-readiness summaries.
  • Earlier Claude summary comments duplicated items already handled in commits 496b4fa14 and 905457b27.

Validation

  • pnpm exec prettier --check docs/oss/migrating/example-migrations.md docs/oss/migrating/migrating-from-react-rails.md
  • script/check-docs-sidebar origin/main
  • lychee --config .lychee.toml docs/oss/migrating/example-migrations.md docs/oss/migrating/migrating-from-react-rails.md
  • git diff --check
  • Pre-commit and pre-push hooks passed.
  • Post-push checks: docs/sidebar/link/CodeQL/CodeRabbit/Cursor checks passed or skipped. claude-review failed because the Claude Code action hit quota (You've hit your limit · resets 7am (UTC)), not because of a repo/test failure.

Follow-up issue: none.

Future full-PR scans should start after this comment unless check all reviews is requested.

@justin808
Copy link
Copy Markdown
Member Author

@claude review this PR.

@justin808 justin808 merged commit 3605761 into main Apr 23, 2026
11 of 12 checks passed
@justin808 justin808 deleted the jg/fix-3125 branch April 23, 2026 07:18
justin808 added a commit that referenced this pull request May 4, 2026
…rn/npm-security-dd6aeadc3f

* origin/main: (34 commits)
  fix(pro-dummy): make manual node-renderer validation reliable (#3200)
  [codex] Add Markdown Prettier CI check (#3242)
  Add /stress-test Claude Code command for adversarial QA (#3207)
  Document examples catalog and naming plan (#3191)
  test(dummy): enable StrictMode in OSS and Pro dummies (#3206)
  ci: exclude bot-blocking URLs from lychee link check (#3214)
  Remove stale Coveralls integration (#3204)
  docs: normalize external GitHub repo slugs in links and generators (#3198)
  docs: add Example Migrations page (#3125) (#3197)
  docs: warn about react_component helper collision with react-rails (#3143) (#3160)
  docs: legacy Webpacker and migration-fit guidance (#3138) (#3157)
  fix(specs): boot dummy specs without readline and drop redundant pnpm workspace (#3190)
  docs: add RSC migration success stories page (#1985) (#3162)
  Fix Bencher reporting permanently broken on pushes to main (#3148)
  docs: add example migrations guide (#3126)
  docs: remove defunct guavapass.com reference (#3199)
  chore: remove redundant --rsc-pro install generator flag (#3105)
  ci: warn (don't fail) on Bencher main regression (#3168)
  test: enable RSpec --profile to surface slowest package tests (#3176)
  fix(node-renderer): expose performance in VM context when supportModules (#3158)
  ...
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.

1 participant