docs: cross-link the TanStack Start comparison from the decision guide and Next.js RSC doc

[justin808]

What

Two cross-links now that the decision-guide section (#4242) and the RoR Pro vs TanStack Start architecture comparison (#4246) are both on main:

• The decision guide's "React on Rails vs TanStack Start" section now links the deep architecture comparison — parallel to how it already links the Next.js RSC comparison.
• The Next.js RSC comparison doc's "Related documentation" now links its TanStack Start sibling.

Closes the asymmetry created by #4242 and #4246 landing as separate PRs.

Gates

• prettier@3.6.2 ✓ (no reformatting needed)
• node script/generate-llms-full.mjs ✓
• lychee ✓ 35 OK / 0 errors (the new relative links resolve to the on-main docs)

Labels: none (docs-only).

🤖 Generated with Claude Code

Summary by CodeRabbit

• Documentation
  • Expanded the React on Rails and TanStack comparison content with an additional link to a deeper architecture overview.
  • Added a new related-docs reference for the React on Rails Pro and TanStack Start comparison.
  • Updated the documentation index so the new comparison page is easier to discover.

[chatgpt-codex-connector]

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

[coderabbitai]

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: 5f297b74-091d-4352-8a10-13051eabb812

📥 Commits

Reviewing files that changed from the base of the PR and between 606241e and 0baf613.

📒 Files selected for processing (4)

• docs/oss/getting-started/comparing-react-on-rails-to-alternatives.md
• docs/pro/react-server-components/nextjs-comparison.md
• llms-full-pro.txt
• llms-full.txt

---

Walkthrough

Adds cross-references to the new tanstack-start-comparison.md page in the OSS alternatives comparison doc and the Next.js RSC comparison's related-docs list, and inserts a corresponding entry into both generated LLM index files (llms-full.txt, llms-full-pro.txt).

Changes

TanStack Start comparison cross-links

Layer / File(s)	Summary
Docs cross-links and LLM index updates docs/oss/getting-started/comparing-react-on-rails-to-alternatives.md, docs/pro/react-server-components/nextjs-comparison.md, llms-full.txt, llms-full-pro.txt	Expands the TanStack Start runnable-example sentence to link to the architecture comparison page, adds a related-docs bullet in the Next.js comparison, and inserts the new page entry into both LLM index files.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~2 minutes

Possibly related PRs

• shakacode/react_on_rails#4242: Introduced the TanStack Start decision-guide content that this PR links to from multiple docs pages.
• shakacode/react_on_rails#4246: Created the tanstack-start-comparison.md page that this PR indexes and cross-links.
• shakacode/react_on_rails#4158: Originally published nextjs-comparison.md, the same file receiving a new related-docs entry here.

Suggested labels

documentation

🚥 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 title accurately summarizes the docs-only cross-linking update between the decision guide and the Next.js RSC comparison.
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.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch jg/tanstack-comparison-crosslinks

---

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.}

[greptile-apps]

Greptile Summary

This PR adds cross-links between the docs comparison pages.

• Adds a TanStack Start architecture comparison link to the decision guide.
• Adds the TanStack Start comparison to the Next.js RSC related docs.
• Updates the generated LLM documentation files to match.

Confidence Score: 5/5

This looks safe to merge.

• No blocking issues found in the changed code.

Important Files Changed

Filename	Overview
docs/oss/getting-started/comparing-react-on-rails-to-alternatives.md	Adds a cross-link from the TanStack Start section to the Pro architecture comparison.
docs/pro/react-server-components/nextjs-comparison.md	Adds the TanStack Start comparison to the related documentation list.
llms-full.txt	Mirrors the decision guide link addition in generated documentation text.
llms-full-pro.txt	Mirrors the Next.js RSC related-docs link addition in generated documentation text.

_{Reviews (1): Last reviewed commit: "docs: cross-link the TanStack Start comp..." | Re-trigger Greptile}

[claude]

This PR adds two cross-links: the TanStack Start section of the decision guide now links the deep architecture comparison doc, and the Next.js RSC comparison's Related documentation section now links its TanStack Start sibling. All relative paths resolve correctly, the target file exists, bidirectional link symmetry between tanstack-start-comparison.md and nextjs-comparison.md is now complete, and the llms-full*.txt files faithfully mirror their source markdown.

Two confirmed issues worth addressing:

1. llms-full.txt cross-bundle reference (see inline on comparing-react-on-rails-to-alternatives.md) — the new sentence directs LLMs to tanstack-start-comparison.md, but that page lives only in llms-full-pro.txt. An LLM given only the OSS bundle sees a "see also" pointer to content that isn't in its context window.

2. Asymmetric placement in nextjs-comparison.md (see inline) — tanstack-start-comparison.md's "Which should you choose?" section already cross-links to nextjs-comparison.md at the decision-point. The reverse link added here lands only in the lower-prominence "Related documentation" section. Adding a matching entry to nextjs-comparison.md's "Which should you choose?" would close the asymmetry.

Minor nit: the two new links use different text for the same target — comparing-react-on-rails-to-alternatives.md uses the full H1 ("React on Rails Pro and TanStack Start: Two Ways to Own the Full Stack") while nextjs-comparison.md uses the shortened form ("React on Rails Pro and TanStack Start"). Not wrong, but aligning them would be cleaner.

[justin808]

Re-review dispositions (head 0baf61305; all required checks green, mergeStateStatus: CLEAN). Resolving:

• llms-full cross-bundle link (L139): the decision guide (OSS bundle) already links the Pro nextjs-comparison.md the same way — this PR just adds the parallel link to tanstack-start-comparison.md. The link is a valid reactonrails.com/docs/… path that resolves on the live site (the generator's docs-URL validation passes), and OSS→Pro cross-references are the established pattern here. The OSS/Pro llms-bundle split is orthogonal and not introduced by this link.
• Placement symmetry (L257): "Related documentation" is the conventional home for a sibling-doc "see also." tanstack-start-comparison.md links back from its "Which should you choose?" selection section; the reciprocal pointer fits naturally under Related documentation here.

Docs-only, required checks green, lychee 0 errors. Beta phase (main), development mode. Enqueuing.