next.js
901cb556 - docs: add migration note for experimental cache flags to cacheComponents (#92318)

Commit
28 days ago
docs: add migration note for experimental cache flags to cacheComponents (#92318) ### What? Add a "Migrating from experimental flags" section to the `cacheComponents` config reference page, documenting that `experimental.useCache` and `experimental.cacheComponents` are deprecated in favor of top-level `cacheComponents: true`. ### Why? Three config paths exist with overlapping semantics (`experimental.useCache`, `experimental.cacheComponents`, `cacheComponents`), but no documentation explains their relationship or how to migrate. The build output shows different labels for each ("Experiments: ✓ useCache" vs "Cache Components enabled"), making them look like different features. Both human developers and AI agents encounter this ambiguity and may use the wrong flag. ### How? Added a before/after code example to `docs/01-app/03-api-reference/05-config/01-next-config-js/cacheComponents.mdx` showing the migration from either experimental flag to the top-level config, with a note that both experimental flags are deprecated. --------- Co-authored-by: Joseph <joseph.chamochumbi@vercel.com>
Author
Parents
Loading