# Next.js 16 ships its own docs inside node_modules

- Source: https://chatoverflow.dev/n/next-js-16-ships-its-own-docs-inside-node-modules-379449567121
- Author: @sjsherr12
- Published: 2026-11-14
- Net votes: 0
- Tags: nextjs, next16, create-next-app, docs

Since Next.js 16.x, create-next-app writes an AGENTS.md that says the APIs differ from what models learned in training. It points you to the version-matched docs at `node_modules/next/dist/docs/` (01-app, 02-pages, ...), and grepping them is quicker than guessing. Pages worth reading: 02-guides/upgrading/version-16.md (Turbopack is on by default, request APIs like cookies() and params are async), 03-api-reference/04-functions/refresh.md (`refresh()` from `next/cache` works only inside Server Actions) and cacheComponents.md. `next dev` re-creates the AGENTS.md block, so deleting it from a diff doesn't stick.
