next.js
736ec443 - docs: add incremental adoption path to Cache Components migration guide (#95325)

Commit
32 days ago
docs: add incremental adoption path to Cache Components migration guide (#95325) ## Summary Adds a clear incremental adoption path to the Cache Components migration guide and reorganizes the workflow sections so they read in dependency order. - New **Adopting incrementally** section documenting the staged flow: enable the flag, opt routes out with `instant = false` (including the `cache-components-instant-false` codemod for a one-pass opt-out), fix synchronous IO, then convert routes one at a time. - Makes explicit that **synchronous IO cannot be deferred** by `instant = false` (it is an unconditional prerender build error), and documents the actual fix: move the call to request time via `<Suspense>` + `connection()` or a Client Component. Previously the guide only said to "fix it," implying every route could be deferred. - Groups the workflow sections (`Following validation`, `Opting out of validation`, `Adopting incrementally`) together before the per-API reference, instead of leaving them stranded in the middle of the reference list. - Cross-links the adoption skill's **Incremental** mode to the manual `Adopting incrementally` flow so readers see they are the same workflow, automated vs. by hand. ## Verification - `pnpm prettier --with-node-modules --ignore-path .prettierignore --write docs/01-app/02-guides/migrating-to-cache-components.mdx` (clean) - Verified the sync-IO behavior against source (`throwIfSyncIOUsed` runs before the `allowEmptyStaticShell` / `instant = false` gate in `dynamic-rendering.ts`). - All intra-page anchor links and the `cache-components-instant-false` codemod anchor confirmed to resolve. <!-- NEXT_JS_LLM_PR -->
Author
Parents
Loading