Skip to content

docs: refocus react server components post#821

Merged
tannerlinsley merged 1 commit intomainfrom
docs/react-server-components-post-review
Apr 12, 2026
Merged

docs: refocus react server components post#821
tannerlinsley merged 1 commit intomainfrom
docs/react-server-components-post-review

Conversation

@tannerlinsley
Copy link
Copy Markdown
Member

@tannerlinsley tannerlinsley commented Apr 12, 2026

Summary

  • tighten the react server components post around the core thesis: RSCs as composable data first, Composite Components as the next-level composition model
  • move the article toward a clearer ecosystem baseline -> tradeoff -> TanStack twist progression and cut the API-heavy sections that belong in docs
  • rename the post asset path to react-server-components and keep links pointing to the dedicated Server Components docs for technical details

Notes

  • commit intentionally excludes unrelated local changes in media/brand.sketch and docs/performance-plan-home-library-docs.md
  • ready for Manuel and Jack to review

Summary by CodeRabbit

  • Documentation
    • Updated React Server Components blog post with reorganized content and simplified explanations to improve readability.
    • Condensed technical details and removed low-level API sections for a more accessible overview.

@netlify
Copy link
Copy Markdown

netlify bot commented Apr 12, 2026

Deploy Preview for tanstack ready!

Name Link
🔨 Latest commit f8ef9bd
🔍 Latest deploy log https://app.netlify.com/projects/tanstack/deploys/69dbdebc5f07f00009f81123
😎 Deploy Preview https://deploy-preview-821--tanstack.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
1 paths audited
Performance: 34 (🔴 down 9 from production)
Accessibility: 90 (no change from production)
Best Practices: 83 (🔴 down 9 from production)
SEO: 97 (no change from production)
PWA: 70 (no change from production)
View the detailed breakdown and full score reports

To edit notification comments on pull requests, go to your Netlify project configuration.

@coderabbitai
Copy link
Copy Markdown

coderabbitai bot commented Apr 12, 2026

📝 Walkthrough

Walkthrough

A blog post on React Server Components was rewritten to shift narrative focus from detailed Composite Components explanations toward higher-level RSC framing as data structures. Large sections covering composition patterns, low-level APIs, and serialization details were removed or condensed, with the header image path updated.

Changes

Cohort / File(s) Summary
Documentation Rewrite
src/blog/react-server-components.md
Refactored blog post narrative: de-emphasized Composite Components, removed low-level API section and detailed proxy/serialization walkthroughs, simplified code examples, updated image path reference from /blog-assets/composite-components/header.jpg to /blog-assets/react-server-components/header.jpg, adjusted security and API-surface language to reference TanStack Start's RSC model.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Poem

🐰 ✨ A tale retold, more clearly now—
RSCs dance like data bows,
Composite steps fade to later days,
While simple truths light brighter ways.
The blog hops forward, light and lean! 🍃

🚥 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 'docs: refocus react server components post' directly and accurately describes the main change: restructuring and refocusing a React Server Components documentation post around its core thesis, removing API-heavy sections.
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 docs/react-server-components-post-review

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

Copy link
Copy Markdown

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

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
src/blog/react-server-components.md (1)

208-208: ⚠️ Potential issue | 🔴 Critical

Remove or update the broken documentation link to loaderDeps.

The link references /router/latest/docs/framework/react/guide/data-loading#using-loaderdeps-to-access-search-params, but this documentation does not exist in the repository. The data-loading guide is not present, and the anchor #using-loaderdeps-to-access-search-params does not exist. Either provide the correct documentation link or remove the reference entirely.

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

In `@src/blog/react-server-components.md` at line 208, The markdown contains a
broken link to `loaderDeps` (the URL
`/router/latest/docs/framework/react/guide/data-loading#using-loaderdeps-to-access-search-params`)
in the sentence starting "Router caching is effectively zero-config..."; either
remove the bracketed link text and keep the explanatory sentence or replace the
href with the correct documentation URL that actually contains `loaderDeps`
usage. Update the line referencing `loaderDeps` so the anchor/guide exists or
drop the link entirely to avoid a 404.
🧹 Nitpick comments (1)
src/blog/react-server-components.md (1)

20-20: Consider hyphenating "built-in" for consistency.

The phrase "feel built in" could be hyphenated as "feel built-in" for grammatical consistency when used as a compound modifier. This is a minor stylistic choice.

📝 Optional style adjustment
-It makes server rendering, streaming, and colocated server-side work feel built in.
+It makes server rendering, streaming, and colocated server-side work feel built-in.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@src/blog/react-server-components.md` at line 20, Change the phrase "feel
built in" to the hyphenated form "feel built-in" in the document (look for the
sentence containing "That model has real benefits. It makes server rendering,
streaming, and colocated server-side work feel built in.") to use the compound
modifier consistently and improve grammar.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Outside diff comments:
In `@src/blog/react-server-components.md`:
- Line 208: The markdown contains a broken link to `loaderDeps` (the URL
`/router/latest/docs/framework/react/guide/data-loading#using-loaderdeps-to-access-search-params`)
in the sentence starting "Router caching is effectively zero-config..."; either
remove the bracketed link text and keep the explanatory sentence or replace the
href with the correct documentation URL that actually contains `loaderDeps`
usage. Update the line referencing `loaderDeps` so the anchor/guide exists or
drop the link entirely to avoid a 404.

---

Nitpick comments:
In `@src/blog/react-server-components.md`:
- Line 20: Change the phrase "feel built in" to the hyphenated form "feel
built-in" in the document (look for the sentence containing "That model has real
benefits. It makes server rendering, streaming, and colocated server-side work
feel built in.") to use the compound modifier consistently and improve grammar.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 4a11b6f0-6b16-40b5-a133-c0eec72181d4

📥 Commits

Reviewing files that changed from the base of the PR and between d414e3e and f8ef9bd.

⛔ Files ignored due to path filters (2)
  • public/blog-assets/composite-components/header.jpg is excluded by !**/*.jpg
  • public/blog-assets/react-server-components/header.jpg is excluded by !**/*.jpg
📒 Files selected for processing (1)
  • src/blog/react-server-components.md

@tannerlinsley tannerlinsley merged commit 96a1a88 into main Apr 12, 2026
8 checks passed
@tannerlinsley tannerlinsley deleted the docs/react-server-components-post-review branch April 12, 2026 20:08
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