Skip to content

Docs IA 2.0: Server and Client Components #79143

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 30 commits into from
May 15, 2025
Merged

Docs IA 2.0: Server and Client Components #79143

merged 30 commits into from
May 15, 2025

Conversation

delbaoliveira
Copy link
Contributor

@delbaoliveira delbaoliveira commented May 13, 2025

Closes:

Redirects: https://github.com/vercel/front/pull/45564

This PR:

  • Adds new Server and Client Components page to Getting Started
    • Explains how Server and Client components are rendered
    • Clarifies when to use them
    • Reviews and simplifies composition patterns (examples)
  • Improves the How does PPR work section in light of static, dynamic, and streaming.

@ijjk ijjk added created-by: Next.js DevEx team PRs by the DX team. Documentation Related to Next.js' official documentation. labels May 13, 2025
Copy link
Contributor

github-actions bot commented May 13, 2025

All broken links are now fixed, thank you!

@delbaoliveira delbaoliveira marked this pull request as ready for review May 13, 2025 10:45
@gaearon
Copy link
Contributor

gaearon commented May 13, 2025

Sorry if these notes aren't timely etc. Not sure how much reshuffling you're looking at. I think there are opportunities to simplify the narrative. Right now it's written a bit as if these are two very different things and you have to make painful tradeoffs between them. It doesn't quite come through in the text how they compose.

I think it may be nicer to explain client components as a way to "layer on" functionality. E.g. show replacing <div> with <ShowMore> or something. So that it feels like you're adding interactivity to your existing "skeleton" of server logic. Thus also starting with showing the composition pattern, and then showing leaves. Just an idea.

@icyJoseph icyJoseph self-requested a review May 13, 2025 19:52
Copy link

changeset-bot bot commented May 14, 2025

⚠️ No Changeset found

Latest commit: 361410b

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@delbaoliveira
Copy link
Contributor Author

Good feedback, thank you @gaearon. It's hard to strike a balance between nuance and conciseness.

I intentionally kept it high-level, as it's part of the Getting Started section. But I'd love to explain the special cases in the future, perhaps in a deep dive.

Hopefully, these recent updates will help fight the sentiment that it is not a trade-off?

@gaearon
Copy link
Contributor

gaearon commented May 14, 2025

This is looking quite a bit better to me, thanks!

@delbaoliveira delbaoliveira merged commit 9c757f6 into canary May 15, 2025
69 checks passed
@delbaoliveira delbaoliveira deleted the docs-ia-rscs branch May 15, 2025 13:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
created-by: Next.js DevEx team PRs by the DX team. Documentation Related to Next.js' official documentation.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants