Skip to content

docs: normalize external GitHub repo slugs in links and generators#3198

Open
justin808 wants to merge 3 commits intomainfrom
jg/repo-slug-cleanup
Open

docs: normalize external GitHub repo slugs in links and generators#3198
justin808 wants to merge 3 commits intomainfrom
jg/repo-slug-cleanup

Conversation

@justin808
Copy link
Copy Markdown
Member

@justin808 justin808 commented Apr 23, 2026

Summary

Updates stale GitHub repo references across docs, generator templates, and specs to match the canonical repository slugs — react_on_rails_demo_ssr_hmrreact-on-rails-demo-ssr-hmr, react_on_rails-demosreact-on-rails-demos, react-server-components-marketplace-demoreact-on-rails-demo-marketplace-rsc, and react-on-rails-migration-examplereact-on-rails-example-migration. Generator templates, demo_page_config, and the create-react-on-rails-app smoke-test grep are updated alongside docs so freshly generated apps link to the correct repos; the main shakacode/react_on_rails repo slug is intentionally preserved. Also replaces one pre-existing broken create-remix link (surfaced by the lychee pre-push hook) with the valid repo root URL.

Pull Request checklist

  • [ ] Add/update test to cover these changes — link-text only
  • [ ] Update documentation — this PR is the doc update
  • [ ] Update CHANGELOG file — no user-facing runtime change

Other Information

Affected spec: react_on_rails/spec/react_on_rails/generators/install_generator_spec.rb now asserts the new marketplace RSC demo URL string.


Note

Low Risk
Low risk: changes are limited to documentation/comment/link updates plus matching spec/smoke-test string expectations, with no runtime behavior changes.

Overview
Normalizes external GitHub links across docs, generator templates, and generated landing-page configs to use the canonical repo slugs (notably react-on-rails-demo-ssr-hmr, react-on-rails-demos, and react-on-rails-demo-marketplace-rsc).

Updates generator-produced link lists (base_generator, demo_page_config) and corresponding checks in install_generator_spec.rb and the create-react-on-rails-app smoke test to assert the new URLs. Also fixes a broken create-remix link and renames the migration example repo link to react-on-rails-example-migration.

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

Summary by CodeRabbit

  • Documentation

    • Updated external repository links and displayed repo names across guides, tutorials, READMEs, and NEWS to use consistent hyphenated naming.
  • Chores

    • Adjusted generated templates, example links, and header/comment references to point to the renamed example repositories and demo URLs.
  • Tests

    • Updated smoke/test expectations to match the renamed demo repository links.

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented Apr 23, 2026

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: d47400e7-50a2-4ec8-a6f8-3497e05c5c09

📥 Commits

Reviewing files that changed from the base of the PR and between 7555e1f and 12fef22.

📒 Files selected for processing (1)
  • docs/oss/migrating/example-migrations.md
✅ Files skipped from review due to trivial changes (1)
  • docs/oss/migrating/example-migrations.md

Walkthrough

This pull request updates GitHub repository reference strings across docs, templates, tests, and scripts, changing underscore-based slugs to hyphenated equivalents (e.g., react_on_rails-demosreact-on-rails-demos, react_on_rails_demo_ssr_hmrreact-on-rails-demo-ssr-hmr, react-server-components-marketplace-demoreact-on-rails-demo-marketplace-rsc).

Changes

Cohort / File(s) Summary
Documentation & analysis
.claude/docs/analysis/RSPACK_IMPLEMENTATION.md, .claude/docs/conductor-compatibility.md, analysis/create-react-on-rails-app-proposal.md, analysis/open-issue-deep-dive/README.md, NEWS.md, docs/oss/building-features/rails-webpacker-react-integration-options.md, docs/oss/core-concepts/react-server-rendering.md, docs/oss/core-concepts/webpack-configuration.md, docs/oss/getting-started/tutorial.md, docs/oss/introduction.md, docs/oss/migrating/example-migrations.md
Replaced displayed repo slugs and hyperlinks to use hyphenated repo names instead of underscore-based names.
Generator core & demo config
react_on_rails/lib/generators/react_on_rails/base_generator.rb, react_on_rails/lib/generators/react_on_rails/demo_page_config.rb
Updated hardcoded demo/marketplace GitHub links to the renamed hyphenated repositories.
Generator templates
react_on_rails/lib/generators/react_on_rails/templates/base/base/babel.config.js.tt, react_on_rails/lib/generators/react_on_rails/templates/base/base/config/webpack/*.js.tt
Updated documentation-reference URLs embedded in ERB/TT templates to point at react-on-rails-demo-ssr-hmr.
Scripts & smoke tests
bin/conductor-exec, packages/create-react-on-rails-app/scripts/smoke-test-local-gems.sh
Adjusted one comment URL and a smoke-test grep/marker to expect the hyphenated marketplace/RSC demo name.
Tests & execjs dummy files
react_on_rails/spec/react_on_rails/generators/install_generator_spec.rb, react_on_rails_pro/spec/execjs-compatible-dummy/*
Updated test expectations and top-of-file comment URLs to match renamed repositories and demo marker names. Multiple comment-only updates across dummy webpack config files.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~15 minutes

Possibly related PRs

Suggested reviewers

  • alexeyr-ci2
  • Judahmeek

Poem

🐰 Hyphens hop where underscores slept,
Links refreshed while I adeptly crept,
Demos renamed with tidy flair,
I nibble bugs and straighten each pair,
Hooray — the repo paths now neatly stepped! 🥕

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The PR title clearly summarizes the main change: normalizing external GitHub repository slugs across documentation and generators from various outdated formats to canonical names.
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/repo-slug-cleanup

Warning

Review ran into problems

🔥 Problems

Git: Failed to clone repository. Please run the @coderabbitai full review command to re-trigger a full review. If the issue persists, set path_filters to include or exclude specific files.


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 performs a mechanical, cross-cutting normalization of GitHub repository slugs — replacing underscored/old slug forms (react_on_rails_demo_ssr_hmr, react_on_rails-demos, react-server-components-marketplace-demo, react-on-rails-migration-example) with their canonical hyphenated equivalents across docs, generator templates, spec fixtures, and the smoke-test script. Generator Ruby source and its corresponding RSpec assertion are updated together so the test continues to reflect the generated output, and a pre-existing broken create-remix deep-link is replaced with the valid repo root URL.

Confidence Score: 5/5

Safe to merge — all changes are URL string corrections with no runtime logic impact.

Every change is a textual slug substitution in documentation, comments, or string literals. Generator Ruby code and its spec are kept in sync. The smoke-test grep is updated to match the new slug. No logic, data, or security concerns are present.

No files require special attention.

Important Files Changed

Filename Overview
react_on_rails/lib/generators/react_on_rails/base_generator.rb Two URL updates: react-server-components-marketplace-demo → react-on-rails-demo-marketplace-rsc in generator config hashes
react_on_rails/lib/generators/react_on_rails/demo_page_config.rb Two URL updates: react-server-components-marketplace-demo → react-on-rails-demo-marketplace-rsc in demo page config arrays
react_on_rails/spec/react_on_rails/generators/install_generator_spec.rb Spec assertions updated to expect the new marketplace RSC demo URL; correctly mirrors the generator change
packages/create-react-on-rails-app/scripts/smoke-test-local-gems.sh Smoke test grep string updated to match new react-on-rails-demo-marketplace-rsc slug
docs/oss/building-features/rails-webpacker-react-integration-options.md URL slug update including a commit-hash deep-link to react-on-rails-demo-ssr-hmr; valid if repo was renamed (history preserved)
analysis/create-react-on-rails-app-proposal.md Multiple slug updates and broken create-remix deep-link replaced with repo root URL
docs/README.md react-on-rails-migration-example → react-on-rails-example-migration slug corrected
docs/oss/migrating/migrating-from-react-rails.md Migration example repo slug corrected to match react-on-rails-example-migration

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[Old slug references] --> B{File type}
    B --> C[Docs / Markdown\ndocs/, NEWS.md, analysis/]
    B --> D[Generator templates\n*.js.tt]
    B --> E[Generator Ruby source\nbase_generator.rb\ndemo_page_config.rb]
    B --> F[Specs & smoke tests\ninstall_generator_spec.rb\nsmoke-test-local-gems.sh]
    B --> G[Pro dummy fixtures\nreact_on_rails_pro/spec/]
    C --> C1[react_on_rails_demo_ssr_hmr\n→ react-on-rails-demo-ssr-hmr]
    C --> C2[react_on_rails-demos\n→ react-on-rails-demos]
    C --> C3[react-on-rails-migration-example\n→ react-on-rails-example-migration]
    D --> D1[react_on_rails_demo_ssr_hmr\n→ react-on-rails-demo-ssr-hmr]
    E --> E1[react-server-components-marketplace-demo\n→ react-on-rails-demo-marketplace-rsc]
    F --> F1[Assertions / greps updated\nto match new slugs]
    G --> G1[react_on_rails_demo_ssr_hmr\n→ react-on-rails-demo-ssr-hmr]
Loading

Reviews (1): Last reviewed commit: "docs: normalize external GitHub repo slu..." | Re-trigger Greptile

@claude
Copy link
Copy Markdown
Contributor

claude Bot commented Apr 23, 2026

Code Review — PR #3198: Normalize external GitHub repo slugs

Overall: Clean, well-scoped docs maintenance PR. The changes are purely link/slug normalization with no runtime logic affected. The test and smoke-test script are correctly updated to match the new URL strings.


What looks good

  • All four repo slug changes are applied consistently across docs, generator templates, and generator Ruby code.
  • Both base_generator.rb and demo_page_config.rb are updated in lockstep — no missed occurrences.
  • The install_generator_spec.rb assertions and the smoke-test-local-gems.sh grep are updated to match the new URLs, so CI will catch regressions.
  • Incidental fix: a missing trailing newline is added to commonWebpackConfig.js.tt.
  • No CHANGELOG entry needed — correct for a docs-only change with no user-facing runtime impact.

Things worth double-checking before merging

1. Deep-link file paths in webpack template comments

The generator .tt files embed source-reference comments like:

// https://github.com/shakacode/react-on-rails-demo-ssr-hmr/blob/master/babel.config.js

These point to specific files on the master branch of the renamed repo. GitHub does not redirect branch-level deep links on renamed repos — only the top-level repo URL redirects. If the default branch in shakacode/react-on-rails-demo-ssr-hmr is main (not master), these links will 404 for users who look them up in freshly generated apps. Worth confirming the branch name before merging.

2. react-on-rails-migration-examplereact-on-rails-example-migration

This is a word-order swap, not just hyphen normalization. The PR description says this is the canonical repo name — just a quick sanity-check that github.com/shakacode/react-on-rails-example-migration exists and is the right target.

3. create-remix link changed to the monorepo root

analysis/create-react-on-rails-app-proposal.md changes the create-remix reference from the package subdirectory to the repo root. The old tree path was broken, so this is an improvement. Since this is an internal analysis document, it is low priority.


Minor nit

The two .claude/docs/ files (.claude/docs/analysis/RSPACK_IMPLEMENTATION.md and .claude/docs/conductor-compatibility.md) appear in the diff — these are Claude-internal operational docs. Including them is fine, just worth confirming it is intentional.


Verdict: LGTM pending confirmation that the master branch still exists in the renamed react-on-rails-demo-ssr-hmr repo (point 1 above). That is the only change that could affect users of freshly generated apps.

Comment thread docs/oss/migrating/migrating-from-react-rails.md Outdated
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Apr 23, 2026

size-limit report 📦

Path Size
react-on-rails/client bundled (gzip) 62.76 KB (0%)
react-on-rails/client bundled (gzip) (time) 62.76 KB (0%)
react-on-rails/client bundled (brotli) 53.86 KB (0%)
react-on-rails/client bundled (brotli) (time) 53.86 KB (0%)
react-on-rails-pro/client bundled (gzip) 63.71 KB (0%)
react-on-rails-pro/client bundled (gzip) (time) 63.71 KB (0%)
react-on-rails-pro/client bundled (brotli) 54.63 KB (0%)
react-on-rails-pro/client bundled (brotli) (time) 54.63 KB (0%)
registerServerComponent/client bundled (gzip) 127.53 KB (0%)
registerServerComponent/client bundled (gzip) (time) 127.53 KB (0%)
registerServerComponent/client bundled (brotli) 61.7 KB (0%)
registerServerComponent/client bundled (brotli) (time) 61.7 KB (0%)
wrapServerComponentRenderer/client bundled (gzip) 122.02 KB (0%)
wrapServerComponentRenderer/client bundled (gzip) (time) 122.02 KB (+0.01% 🔺)
wrapServerComponentRenderer/client bundled (brotli) 56.73 KB (0%)
wrapServerComponentRenderer/client bundled (brotli) (time) 56.73 KB (0%)

@coderabbitai coderabbitai Bot added review-needed documentation docs-cleanup Documentation cleanup or migration labels Apr 23, 2026
@justin808
Copy link
Copy Markdown
Member Author

Review summary — addressed

I (Claude Code) triaged all 6 review comments. No code changes required; all concerns verified locally.

Inline questions (verified, threads resolved)

  • babel.config.js.tt deep links (@claude): Confirmed shakacode/react-on-rails-demo-ssr-hmr default branch is still master and babel.config.js exists at root. /blob/master/... deep links resolve correctly. → reply
  • react-on-rails-example-migration slug (@claude): Confirmed the repo exists with that exact name and resolves correctly. → reply

Other reviews

  • @claude review summary: All three "things worth double-checking" map to the inline questions above — all verified above. The create-remix link change is an improvement (the old subdirectory path was broken). The two .claude/docs/ files in the diff contain valid slug fixes (react_on_rails-demosreact-on-rails-demos) and are intentional — same normalization as the rest of the PR.
  • @greptile-apps (5/5 confidence, safe to merge): Acknowledged. Thanks for the thorough review.
  • @coderabbitai / @github-actions (size-limit): No actionable items.

All review threads are now resolved. Ready for merge once CI is green.

@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 triage! Glad the deep-link paths and the react-on-rails-example-migration slug both checked out. The PR looks clean — purely normalizing slugs with no runtime impact. I'll resolve my open threads now.

[resolve]


🧠 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: 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

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: justin808
Repo: shakacode/react_on_rails PR: 2886
File: docs/sidebars.ts:9-251
Timestamp: 2026-03-29T08:38:50.670Z
Learning: In the `shakacode/react_on_rails` repository, `docs/sidebars.ts` uses sidebar doc IDs **without** an `oss/` prefix (e.g., `'api-reference/javascript-api'`, `'building-features/caching'`). Although OSS doc files are physically located at `docs/oss/...`, Docusaurus is configured to remap that path so those IDs resolve correctly without the prefix. Pro docs use the `pro/` prefix (e.g., `'pro/react-on-rails-pro'`). Do not suggest adding an `oss/` prefix to sidebar IDs in this repo.

Learnt from: CR
Repo: shakacode/react_on_rails PR: 0
File: AGENTS.md:0-0
Timestamp: 2026-04-10T04:28:46.123Z
Learning: Applies to CHANGELOG.md : Format CHANGELOG entries as `[PR NUMBER](url) by [username](url)` without hash before PR number; use inline `**[Pro]**` prefix for Pro-only features

@greptile-apps
Copy link
Copy Markdown

greptile-apps Bot commented Apr 23, 2026

Thanks for the thorough follow-up. All concerns are verified — the deep links resolve correctly, the react-on-rails-example-migration slug is confirmed, and the create-remix fix is an improvement. Nothing blocking here. ✅ Ready to merge once CI is green.

Updates stale GitHub repo references across docs, generator templates,
and specs to match the canonical repository slugs:

- react_on_rails_demo_ssr_hmr -> react-on-rails-demo-ssr-hmr
- react_on_rails-demos -> react-on-rails-demos
- react-server-components-marketplace-demo -> react-on-rails-demo-marketplace-rsc
- react-on-rails-migration-example -> react-on-rails-example-migration

Generator templates, demo page config, and the create-react-on-rails-app
smoke-test grep are updated alongside docs so freshly generated apps
link to the correct repos. The main shakacode/react_on_rails repo slug
is intentionally preserved.

Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]>
@justin808 justin808 force-pushed the jg/repo-slug-cleanup branch from c13efe5 to f66aa3c Compare April 23, 2026 02:29
@claude
Copy link
Copy Markdown
Contributor

claude Bot commented Apr 23, 2026

Code Review: PR #3198 — Normalize external GitHub repo slugs

Overview

Straightforward housekeeping: normalizes stale external repo slugs across docs, generator templates, Ruby config files, smoke-test scripts, and RSpec expectations. No runtime behavior changes.

What's Good

  • Consistent change scope: Generator templates, base_generator.rb, demo_page_config.rb, the smoke-test grep assertion, and install generator specs all change together—a partial update would have left a broken test.
  • Incidental EOF fix: commonWebpackConfig.js.tt gains a missing newline at EOF, a minor quality improvement.
  • create-remix link simplification: Changing from the specific package path (remix/tree/main/packages/create-remix) to the repo root is safer and more resilient to future monorepo restructuring.

Issues

1. Possible missed update: docs/oss/migrating/example-migrations.md line 38

The PR description lists react-on-rails-migration-example → react-on-rails-example-migration as one of the slug renames, but docs/oss/migrating/example-migrations.md is not in the diff and still contains:

[react-on-rails-migration-example](https://github.com/shakacode/react-on-rails-migration-example)

If the external repo was renamed, this link needs updating. If the rename hasn't happened yet and this was noted only for future reference, the PR description should clarify that.

2. Template reference URLs use master branch

All eight generator .tt templates and six execjs-compatible-dummy spec files now reference react-on-rails-demo-ssr-hmr at the master branch (e.g. blob/master/babel.config.js). If the renamed repo's default branch is main, every one of these reference links will 404 for developers reading generated files. Please confirm the branch name in shakacode/react-on-rails-demo-ssr-hmr before merging.


Minor notes

  • The .claude/docs/ internal files are correctly updated alongside public docs—good consistency.
  • The specific commit hash in rails-webpacker-react-integration-options.md (7e53803) stays valid after a GitHub repo rename, so no issue there.

Verdict

Correct in the files it touches. Recommend resolving the two items above before merge—especially the master vs main branch question, since a wrong branch name in generated files will be a silent broken link for every user who runs the generator.

Comment thread react_on_rails_pro/spec/execjs-compatible-dummy/config/webpack/webpackConfig.js Outdated
justin808 and others added 2 commits April 22, 2026 19:58
Line 38 still referenced the old slug react-on-rails-migration-example
despite PR #3198 listing the rename to react-on-rails-example-migration.
New slug verified to resolve to the correct repo.

Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]>
@justin808
Copy link
Copy Markdown
Member Author

Thanks for the review. Addressing both findings:

Finding #1docs/oss/migrating/example-migrations.md:38: Good catch. This file wasn't in the original PR diff but did contain the old react-on-rails-migration-example slug. Fixed in commit 12fef2271, which updates both the link text and URL to react-on-rails-example-migration. Grep confirms no other occurrences remain.

Finding #2master vs main branch: I (Claude Code) verified earlier that shakacode/react-on-rails-demo-ssr-hmr's default branch is still master and that babel.config.js plus all eight config/webpack/* files exist at those blob/master/... paths. The deep links resolve correctly — no 404s. No action needed.

@justin808
Copy link
Copy Markdown
Member Author

Review round 2 — addressed

I (Claude Code) triaged the 3 new review comments posted after the first round. Summary:

Fixed

  • docs/oss/migrating/example-migrations.md:38 (claude[bot]): Replaced stale react-on-rails-migration-example slug with the canonical react-on-rails-example-migration. Fixed in commit 12fef2271. This file was outside the original diff; grep confirms no other occurrences remain.

Skipped (duplicates of already-verified concerns)

  • Inline babel.config.js.tt master vs main (claude[bot]): Duplicates thread above already resolved after verification. Default branch of react-on-rails-demo-ssr-hmr is master; deep links resolve correctly. Thread resolved with rationale reply.
  • Code review Finding Make work with turbolinks and better helper #2 — template URLs use master branch (claude[bot]): Same concern as above; verified across all eight template files. Rationale posted inline on the review comment.

All threads resolved. PR ready for merge review.

@@ -1,5 +1,5 @@
// The source code including full typescript support is available at:
// https://github.com/shakacode/react_on_rails_demo_ssr_hmr/blob/master/config/webpack/webpackConfig.js
// https://github.com/shakacode/react-on-rails-demo-ssr-hmr/blob/master/config/webpack/webpack.config.js
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

The filename in this URL changed from webpackConfig.js to webpack.config.js — that's a different change from all the other files in this PR, which only updated the repo slug and preserved the referenced filename.

Every other webpack config template comment in this PR (clientWebpackConfig.js, serverWebpackConfig.js, commonWebpackConfig.js, development.js, production.js, test.js) keeps its original filename. Only this one silently renamed the file.

Please confirm: does the react-on-rails-demo-ssr-hmr repo actually have the file at config/webpack/webpack.config.js (with a dot), or should this remain webpackConfig.js to match the others?

Suggested change
// https://github.com/shakacode/react-on-rails-demo-ssr-hmr/blob/master/config/webpack/webpack.config.js
// https://github.com/shakacode/react-on-rails-demo-ssr-hmr/blob/master/config/webpack/webpackConfig.js

@claude
Copy link
Copy Markdown
Contributor

claude Bot commented Apr 23, 2026

Code Review

Overall: This is a clean, low-risk docs/link normalization PR. The changes are mechanical and well-scoped. One issue and one minor observation below.

One Issue to Verify

webpackConfig.js URL filename mismatch (see inline comment) — this is the only file in the PR where the referenced filename also changed (webpackConfig.jswebpack.config.js), unlike every other webpack config template which only updated the repo slug. This may be intentional if the file was renamed in the new repo, but it stands out and should be confirmed.

Positive Notes

  • Consistency: All four slug migrations (react_on_rails_demo_ssr_hmrreact-on-rails-demo-ssr-hmr, react_on_rails-demosreact-on-rails-demos, react-server-components-marketplace-demoreact-on-rails-demo-marketplace-rsc, react-on-rails-migration-examplereact-on-rails-example-migration) are applied uniformly across docs, generator templates, Ruby generator config, smoke-test grep assertions, and spec expectations.
  • Generator templates updated: The generator code in base_generator.rb and demo_page_config.rb and the smoke-test assertion in smoke-test-local-gems.sh are all updated, so freshly generated apps will immediately get the correct URLs.
  • Spec parity: install_generator_spec.rb is updated to match — no test drift.
  • Bonus fix: The commonWebpackConfig.js.tt template gained a trailing newline (missing EOF newline removed).
  • Bonus fix: The broken create-remix deep link is corrected to the repo root URL.
  • Scope discipline: The main shakacode/react_on_rails slug is intentionally left unchanged, which is correct.

No Concerns

  • No runtime behavior changes; all changes are in comments, link text, and string literals in docs/templates.
  • No security implications.
  • Test coverage is appropriate for a link-normalization change.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs-cleanup Documentation cleanup or migration documentation review-needed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant