Unify caching story across the docs#90149
Merged
delbaoliveira merged 28 commits intocanaryfrom Mar 3, 2026
Merged
Conversation
Contributor
|
All broken links are now fixed, thank you! |
**Terminology:** - Dynamic APIs → Request-time APIs (explicit, this APIs that access request information) - Dynamic Data → Uncached data (data is either cached or uncached, reserve dynamic for rendering) - Pre-rendering → Prerendering - Prefer prerendering over static rendering where possible. This aligns with better with Partial Prerendering. - Prefer dynamic rendering over runtime/request-time rendering (it's a well established term and it just sounds better) - Dropped caching layers: - Router Cache - Full Route Cache - React Cache - Client Router Cache - Caching layers become: **Client cache** and **Server cache**. The new Cache Component APIs work across caching layers and are not configured independently, allowing us to simplify the story. **Other fixes:** - Run docs through Vercel style guide - Fixed broken links --------- Co-authored-by: Vercel <vercel[bot]@users.noreply.github.com>
icyJoseph
reviewed
Mar 2, 2026
icyJoseph
reviewed
Mar 2, 2026
icyJoseph
reviewed
Mar 2, 2026
docs/01-app/03-api-reference/03-file-conventions/01-metadata/manifest.mdx
Outdated
Show resolved
Hide resolved
icyJoseph
reviewed
Mar 2, 2026
Co-authored-by: Joseph <joseph.chamochumbi@vercel.com>
Co-authored-by: Joseph <joseph.chamochumbi@vercel.com>
…anifest.mdx Co-authored-by: Joseph <joseph.chamochumbi@vercel.com>
Co-authored-by: Joseph <joseph.chamochumbi@vercel.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This PRs unifies the caching story across the docs, making Cache Components the happy path, while still providing guidance to users in the old model. However, instead of explaining the old model and its caching layers, we've created a new guide focusing on what APIs to use and when.
This follow-up PR aligns terminology across the docs: #90589
IA updates
Getting Started section:
caching.mdx(CC-first)revalidating.mdx(CC-first)cacheLifeandcacheTagGuides Section:
caching-and-revalidating.mdx(Previous Model)fetchoptions and route segment configmigrating-to-cache-components.mdx(WIP)caching.mdx😌Terminology
We should remove caching layers from the docs. Users only needed to be exposed to them when they were configured independently, but the new CC APIs work across layers.
To make it easier to review this PR, I'm consolidating terminology and fixing broken links in a new PR: #90589