docs: add unstable_cache → use cache migration guide#92392
Draft
aurorascharff wants to merge 1 commit intocanaryfrom
Draft
docs: add unstable_cache → use cache migration guide#92392aurorascharff wants to merge 1 commit intocanaryfrom
unstable_cache → use cache migration guide#92392aurorascharff wants to merge 1 commit intocanaryfrom
Conversation
The unstable_cache API reference says "use use cache instead" but provides no step-by-step migration path. Add a section to the Migrating to Cache Components guide showing the before/after pattern: unstable_cache wrapper → use cache directive, revalidate → cacheLife, tags → cacheTag, and automatic cache keys replacing keyParts. Also add a link from the unstable_cache API reference to the new migration section. Made-with: Cursor
nextjs-bot
added
created-by: Next.js DevEx team
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
2 participants
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.
What?
Add a step-by-step migration section for
unstable_cache→use cacheto the Migrating to Cache Components guide.Why?
The
unstable_cacheAPI reference says "useuse cacheinstead" but gives no migration path. There is no doc that mapsrevalidate: 3600→cacheLife('hours'),tags: ['x']→cacheTag('x'), and explains thatkeyPartsare no longer needed. A developer or AI agent doing this migration has to piece these together from three separate API reference pages.How?
## unstable_cachesection tomigrating-to-cache-components.mdxwith Before/After code blocks (TSX/JSX switcher), matching the existing pattern used fordynamic,revalidate, andfetchCacheunstable_cacheAPI reference to the new migration sectionImproving Documentation
pnpm prettier-fixto fix formatting issues before opening the PR.Made with Cursor