hanzoai/next.js
2
0
Fork 0
mirror of https://github.com/hanzoai/next.js.git synced 2026-09-24 17:00:51 +00:00
Code Issues Packages Projects Releases Wiki Activity
34,980 Commits 3 Branches 3,979 Tags
canary
Commit Graph
100 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
Delba de OliveiraGitHubvercel[bot] <35613825+vercel[bot]@users.noreply.github.com>
 		fb0686d866 Docs skills: guide and api-reference (#90992) 
Writing skills for guides and API reference for more consistent
formatting.

- `write-guide` - this skill helps create guides with progressive
disclosure and a consistent format (intro, summary, step-by-step
instructions, next steps). Works best when you give agents a demo.
- `write-api-reference`  - this skill looks at the API type (component,
function, file, etc) and helps draft references following a consistent
format. Works best when you give agents context. e.g. source code, PR
descriptions, RFCs. Also explores repo context (e.g. e2e tests)


Note:

- While skills help you write a first draft, they’re 80%. Humans still
need to check for accuracy, test APIs, and take it to 110%.
- If no technical writing guidance is provided, skills work best when
you give it references of past work.

Closes:

- https://linear.app/vercel/issue/DOC-6245/create-guide-skill
- https://linear.app/vercel/issue/DOC-6246/create-api-reference-skill

---------

Co-authored-by: vercel[bot] <35613825+vercel[bot]@users.noreply.github.com>
 2026-03-13 20:14:31 +00:00
Delba de OliveiraandGitHub 2accf8bc41 Docs: Split route segment config options into their own files (#90991) 
Closes:
https://linear.app/vercel/issue/DOC-6221/nextjs-split-route-segments-files-in-preparation-for-instant
 2026-03-13 13:00:00 +00:00
Delba de OliveiraGitHubVercel <vercel[bot]@users.noreply.github.com>Joseph
 		c2b4c0815c Unify caching story across the docs (#90149) 
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:
https://github.com/vercel/next.js/pull/90589

## IA updates

Getting Started section: 

- Improves Getting Started progression:
- **Before:** CC → Fetching Data → Updating Data → Caching and
Revalidating (old and new model mixed)
- **After:** Fetching Data (Dynamic) → Mutating Data (Dynamic) → Caching
with CC (Prerendering) → Revalidating with CC.
- New: `caching.mdx` (CC-first)
   - Structure: 
      - Enabling Cache Components
      - Data vs UI-level caching
      - Working with request time APIs
      - Passing request values to cached functions
      - Working with non-deterministic operations
      - Working with synchronous operations
      - How rendering works (PPR and static shell story)
- New: `revalidating.mdx` (CC-first)
   - Explains how to use `cacheLife` and `cacheTag`

Guides Section: 

- New: `caching-and-revalidating.mdx` (Previous Model)
- For users who are not using CC, includes `fetch` options and route
segment config
- Moves route segment config options that don't apply to CC from API
reference to this guide (for easy archiving in the future).
- New: `migrating-to-cache-components.mdx` (WIP)
- Del: `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:
https://github.com/vercel/next.js/pull/90589

---------

Co-authored-by: Vercel <vercel[bot]@users.noreply.github.com>
Co-authored-by: Joseph <[email protected]>
 2026-03-03 13:14:24 +00:00
Delba de OliveiraandGitHub cbea93f43f CC Guide: Fix filenames, reduce line breaks (#89065) 
Follow-up
 2026-01-27 14:04:39 +00:00
Delba de OliveiraandGitHub d1cf4e6942 Cache Component Guide: Building public, _mostly_ static pages (#87248) 
This PR adds a draft guide for building public pages with Cache
Components and PPR.

Part of a 3-guide series on:

- Building public pages with shared data
- Building page variants with route params (`generateStaticParams`)
- Build private pages with user-specific data

Todo: 

- [x] Link to glossary terms
- [x] Link to video
- [x] Link to demo + code
 2026-01-26 17:19:46 +00:00
Delba de OliveiraGitHubvercel[bot] <35613825+vercel[bot]@users.noreply.github.com>
 		599fc3f82a Docs: Add Next.js Glossary (#88811) 
Add next.js glossary so we can reference concepts in guides without
having to re-explain them. Guides should be succint, like a skill :)

Closes: https://linear.app/vercel/issue/DOC-5574/nextjs-glossary

---------

Co-authored-by: vercel[bot] <35613825+vercel[bot]@users.noreply.github.com>
 2026-01-23 12:04:13 +00:00
Delba de OliveiraGitHubLuke Sandberggraphite-app[bot] <96075541+graphite-app[bot]@users.noreply.github.com>JosephRich Hainesvercel[bot] <35613825+vercel[bot]@users.noreply.github.com>
 		bfeedb070a Guide: Update Optimizing Package Bundling to include new Bundle Analyzer (#87246) 
This PR adds instructions on how to run and navigate the new turbopack
bundle analyzer to the existing [Optimizing package bundling guide
](https://nextjs.org/docs/app/guides/package-bundling).
Todo: 
- [x] Embed video
- [x] Add image for import chain

---------

Co-authored-by: Luke Sandberg <[email protected]>
Co-authored-by: graphite-app[bot] <96075541+graphite-app[bot]@users.noreply.github.com>
Co-authored-by: Joseph <[email protected]>
Co-authored-by: Rich Haines <[email protected]>
Co-authored-by: vercel[bot] <35613825+vercel[bot]@users.noreply.github.com>
 2025-12-19 16:21:14 +00:00
Delba de OliveiraGitHubJoseph
 		ca7f57ee2d Docs: Add version history for next lint deprecation and update error message (#85100) 
Co-authored-by: Joseph <[email protected]>
 2025-10-20 19:58:07 +00:00
Delba de OliveiraandGitHub 4955c5dd6b Docs: Add note on tag limits for cacheTag (#85106) 2025-10-20 14:40:07 +01:00
Delba de OliveiraandGitHub 02c9a7ede4 Docs: Add --debug-build-paths next build option (#85097) 
Related: https://github.com/vercel/next.js/pull/85052
 2025-10-20 14:40:00 +01:00
Delba de OliveiraGitHubgraphite-app[bot] <96075541+graphite-app[bot]@users.noreply.github.com>Jiachi Liu
 		4e96d7d1ad Docs: Document global-not-found (#81803) 
Closes:
https://linear.app/vercel/issue/DOC-4873/document-global-not-found

---------

Co-authored-by: graphite-app[bot] <96075541+graphite-app[bot]@users.noreply.github.com>
Co-authored-by: Jiachi Liu <[email protected]>
 2025-07-22 10:19:49 +00:00
Delba de OliveiraGitHubJoseph Chamochumbi
 		409b14c92e Docs: POC (#81419) 
Closes: 

-
https://linear.app/vercel/issue/DOC-4841/setup-minimum-working-app-in-the-nextjs-repo
- https://linear.app/vercel/issue/DOC-4845/add-community-readme

---------

Co-authored-by: Joseph Chamochumbi <[email protected]>
 2025-07-15 13:37:25 +01:00
Delba de OliveiraGitHubgraphite-app[bot] <96075541+graphite-app[bot]@users.noreply.github.com>
 		fcfae6eba0 15.4 Docs: Minor feature updates (#81618) 
Updates the docs to include the new options in 15.4. 

- `prefetch="auto"` option: https://github.com/vercel/next.js/pull/78689
- `next build` new `--debug-prerender option`:
https://github.com/vercel/next.js/pull/80667

---------

Co-authored-by: graphite-app[bot] <96075541+graphite-app[bot]@users.noreply.github.com>
 2025-07-14 17:33:22 +01:00
Delba de OliveiraGitHubJosephgraphite-app[bot] <96075541+graphite-app[bot]@users.noreply.github.com>
 		2e2ee08b60 Docs IA 2.0: Delete routing section, add BFF guide, polish getting started (#80365) 
Closes:
https://linear.app/vercel/issue/DOC-4686/clean-up-routing-section
Redirects: https://github.com/vercel/front/pull/47151

---------

Co-authored-by: Joseph <[email protected]>
Co-authored-by: graphite-app[bot] <96075541+graphite-app[bot]@users.noreply.github.com>
 2025-06-16 13:42:20 +01:00
Delba de OliveiraGitHubgraphite-app[bot] <96075541+graphite-app[bot]@users.noreply.github.com>
 		2b76ed70bc Docs: Polish Getting Started section (#80402) 
Please merge this PR first: https://github.com/vercel/next.js/pull/80401

- Reorder pages. Group routing + rendering + data fetching, and UI
concerns (styling, css, images, etc)
- Update page titles to use keyword instead of "How to" for search
results

---------

Co-authored-by: graphite-app[bot] <96075541+graphite-app[bot]@users.noreply.github.com>
 2025-06-11 14:02:43 +00:00
Delba de OliveiraGitHubgraphite-app[bot] <96075541+graphite-app[bot]@users.noreply.github.com>
 		22ca7677bb Docs: Getting Started feedback (#80401) 
Closes:

- https://github.com/vercel/next.js/issues/76573
- https://github.com/vercel/feedback/issues/97181
- https://github.com/vercel/feedback/issues/96268
- https://github.com/vercel/feedback/issues/95318
- https://github.com/vercel/feedback/issues/95317
- https://github.com/vercel/feedback/issues/93861
- https://github.com/vercel/feedback/issues/91802
- https://github.com/vercel/feedback/issues/97192

---------

Co-authored-by: graphite-app[bot] <96075541+graphite-app[bot]@users.noreply.github.com>
 2025-06-11 12:42:31 +01:00
Delba de OliveiraGitHubJoseph
 		7114fd23a5 Docs: Clarify how intercepting routes work and update example (#80145) 
Closes: https://github.com/vercel/next.js/issues/78255

---------

Co-authored-by: Joseph <[email protected]>
 2025-06-11 07:34:10 +01:00
Delba de OliveiraGitHubJosephgraphite-app[bot] <96075541+graphite-app[bot]@users.noreply.github.com>Lee Robinson
 		1f3a186a8d Docs: Add prefetching guide (#80152) 
To do: 
- [x] Triggering unwanted side-effects during prefetching -
@delbaoliveira
- [x] Preventing too many prefetches - @delbaoliveira 
- [x] Disabling prefetching on hover - @icyJoseph 
- [x] Ejected link - soft navigation with `onClick` and `router.push` -
@icyJoseph

---------

Co-authored-by: Joseph <[email protected]>
Co-authored-by: graphite-app[bot] <96075541+graphite-app[bot]@users.noreply.github.com>
Co-authored-by: Lee Robinson <[email protected]>
 2025-06-10 08:21:27 -05:00
Delba de OliveiraandGitHub bbaa164737 Docs IA 2.0: Move examples to middleware.js API reference (#80363) 
Part of:
https://linear.app/vercel/issue/DOC-4686/clean-up-routing-section
 2025-06-10 08:00:17 -05:00
Delba de OliveiraGitHubgraphite-app[bot] <96075541+graphite-app[bot]@users.noreply.github.com>
 		39fbaaf46b Docs IA 2.0: Move examples to route.js API reference (#80360) 
Part of:
https://linear.app/vercel/issue/DOC-4686/clean-up-routing-section

---------

Co-authored-by: graphite-app[bot] <96075541+graphite-app[bot]@users.noreply.github.com>
 2025-06-10 07:02:33 -05:00
Delba de OliveiraGitHubgraphite-app[bot] <96075541+graphite-app[bot]@users.noreply.github.com>Joseph
 		24434f18db Docs: Add Data Security Guide (#80249) 
Closes: https://linear.app/vercel/issue/DOC-4678/guide-data-security

Please merge this PR first: https://github.com/vercel/next.js/pull/80242

---------

Co-authored-by: graphite-app[bot] <96075541+graphite-app[bot]@users.noreply.github.com>
Co-authored-by: Joseph <[email protected]>
 2025-06-10 06:52:38 -05:00
Delba de OliveiraGitHubJoseph
 		083b924c01 Docs: Linking and Navigating Page (#80103) 
Closes:
https://linear.app/vercel/issue/DOC-4718/linking-and-navigating-page

This PR: 

- Adds a linking and navigating page to getting started: 
- Introduces how navigation works and the built-in Next.js optimizations
(prefetching, client-side transitions, etc)
   - Discusses what can cause slow transitions and how to optimize it. 
- Updates the loading.js API reference

Redirects: 
- https://github.com/vercel/front/pull/46788

---------

Co-authored-by: Joseph <[email protected]>
 2025-06-06 10:37:16 +01:00
Delba de OliveiraandGitHub e66680dcf9 Docs: Fix headings (#79777) 2025-05-28 11:31:06 +01:00
Delba de OliveiraandGitHub fffb2eb6fb Docs IA 2.0: Delete Error Handling page (#79495) 
The content has already been migrated to
https://nextjs.org/docs/app/getting-started/error-handling.

Closes:
https://linear.app/vercel/issue/DOC-4700/bya-delete-error-handling-page
Redirects: https://github.com/vercel/front/pull/46127
 2025-05-27 14:58:40 +00:00
Delba de OliveiraandGitHub 8b7f937e36 Docs IA 2.0: Add Caching and Revalidating page (#79493) 
Closes:
https://linear.app/vercel/issue/DOC-3700/getting-started-caching-and-revalidating-page
Redirects: https://github.com/vercel/front/pull/46120
 2025-05-27 13:35:36 +01:00
Delba de OliveiraandGitHub 63ed70ba41 Docs IA 2.0: Move Redirects page to guides (#79447) 
Closes: https://linear.app/vercel/issue/DOC-4695/guide-redirects
Redirects: https://github.com/vercel/front/pull/46041
 2025-05-27 12:20:11 +01:00
Delba de OliveiraGitHubIsmael
 		37ee4452b8 Next IA 2.0: Create Route Groups API reference, simplifying wording (#79444) 
Closes:
https://linear.app/vercel/issue/DOC-4676/dynamic-route-segments-api-reference
Redirects: https://github.com/vercel/front/pull/46032

---------

Co-authored-by: Ismael <[email protected]>
 2025-05-27 10:31:44 +00:00
Delba de OliveiraandGitHub 2d81adc520 Docs IA 2.0: Create Dynamic Segments API reference, add example to getting started. (#79439) 
Closes:
https://linear.app/vercel/issue/DOC-4676/dynamic-route-segments-api-reference
Redirects: https://github.com/vercel/next.js/pull/79439
 2025-05-27 10:51:59 +01:00
Delba de OliveiraandGitHub f87fee7b28 Docs IA 2.0: Update template.js API reference (#79490) 
Merge template.js information from BYA and update API reference to
follow the convention.

Please merge this PR first: https://github.com/vercel/next.js/pull/79453
Closes:
https://linear.app/vercel/issue/DOC-4696/routing-section-layouts-and-templates
 2025-05-27 10:30:17 +01:00
Delba de OliveiraGitHubJoseph
 		f18b756cde Docs IA 2.0: Add examples to layout.js (#79453) 
In the **layout.js** API reference, we talk about the limitations of
layouts but don't provide alternative examples. This simplifies the
wording, and adds examples using the recommended APIs.

Also adds more general `layout.js` examples.

Part of:
https://linear.app/vercel/issue/DOC-4696/routing-section-layouts-and-templates

Follow up: Look into template.js

---------

Co-authored-by: Joseph <[email protected]>
 2025-05-27 10:02:17 +01:00
Delba de OliveiraandGitHub d9e41e43d0 Docs IA 2.0: Create intercepting and parallel routes API reference (#79405) 
Parallel and intercepting routes are more "side-quests" than main
features, so they are not included in the Getting Started. We did not
have an API reference for them, so they have been moved under
File-system conventions (which was renamed to account for folder
conventions).

Closes: 

-
https://linear.app/vercel/issue/DOC-4683/api-reference-intercepting-routes
- https://linear.app/vercel/issue/DOC-4684/api-reference-parallel-routes

Redirects: 

- https://github.com/vercel/front/pull/45973
 2025-05-27 09:51:43 +01:00
Delba de OliveiraandGitHub b89caa422a Docs IA 2.0: Create Forms guide (#79288) 
Closes: https://linear.app/vercel/issue/DOC-4671/forms
No redirects needed yet as no pages were deleted.
 2025-05-27 08:34:38 +00:00
Delba de OliveiraGitHubJoseph
 		6020a8b1c0 Docs IA 2.0: Reorder PPR page and fix some nits (#79282) 
Co-authored-by: Joseph <[email protected]>
 2025-05-22 06:15:27 +00:00
Delba de OliveiraandGitHub ed09804153 Docs: Fix broken link (#79456) 2025-05-21 09:48:37 -05:00
Delba de OliveiraandGitHub 72f5429fe0 Docs IA 2.0: Add i18n guides (#79391) 
Closes:
https://linear.app/vercel/issue/DOC-4682/guide-internationalization-i18n
Redirects: https://github.com/vercel/front/pull/45963
 2025-05-21 15:43:02 +01:00
Delba de OliveiraandGitHub f8bbb5e0ed Docs IA 2.0: Review fetching page and move examples (#79200) 
Part of:
https://linear.app/vercel/issue/DOC-4639/ia-20-migrate-bya-pages
No redirects needed yet as the page hasn't been deleted.
 2025-05-21 15:38:11 +01:00
Delba de OliveiraandGitHub f6081d019c Docs IA 2.0: Move ISR page to guides (#79283) 
Closes: https://linear.app/vercel/issue/DOC-4670/isr
Redirects: https://github.com/vercel/front/pull/45793
 2025-05-21 08:34:00 +01:00
Delba de OliveiraandGitHub 9832e844e0 docs: Fix syntax highlighting, add missing js code blocks (#79246) 2025-05-15 14:36:57 +00:00
Delba de OliveiraandGitHub b15817b46c Docs IA 2.0: Delete rendering section (#79244) 
All pages have been migrated. 

Redirects: https://github.com/vercel/front/pull/45728
 2025-05-15 15:20:00 +01:00
Delba de OliveiraandGitHub 9c757f6d5c Docs IA 2.0: Server and Client Components (#79143) 
Closes: 
- https://linear.app/vercel/issue/DOC-4655/client-components
- https://linear.app/vercel/issue/DOC-4656/server-components
- https://linear.app/vercel/issue/DOC-4657/composition-patterns

Redirects: https://github.com/vercel/front/pull/45564

This PR:

- Adds new **Server and Client Components** page to **Getting Started**
   - Explains how Server and Client components are rendered 
   - Clarifies when to use them
   - Reviews and simplifies composition patterns (examples)
- Improves the **How does PPR work** section in light of static,
dynamic, and streaming.
 2025-05-15 14:26:19 +01:00
Delba de OliveiraandGitHub 24dd546207 Docs: Fix page order in Getting Started (#79240) 2025-05-15 12:21:47 +00:00
Delba de OliveiraGitHubLee Robinson
 		04a19c1260 docs: Move Edge Runtime information to API reference (#79152) 
Closes: https://linear.app/vercel/issue/DOC-4658/edge-runtime
Redirects: https://github.com/vercel/front/pull/45645

---------

Co-authored-by: Lee Robinson <[email protected]>
 2025-05-14 12:35:09 +00:00
Delba de OliveiraandGitHub 0e39e7f155 Docs: Visual nits (#79198) 
Fix missing heading and line highlighting
 2025-05-14 11:57:41 +01:00
Delba de OliveiraandGitHub 9173eb10c3 Docs: Add PPR page to getting started section (#79076) 
Closes: https://linear.app/vercel/issue/DOC-4653/partial-prerendering
Related: https://linear.app/vercel/issue/DOC-4555/ppr-and-dio
Redirects: https://github.com/vercel/front/pull/45481

- Creates a placeholder page for PPR in Getting Started.
- Reviews and updates content
- Adds examples
 2025-05-13 08:51:42 +01:00
Delba de OliveiraGitHubLee Robinson
 		f3ad435ff3 docs: Merge CSS pages (#78996) 
Closes: https://linear.app/vercel/issue/DOC-4648/css
Redirects: https://github.com/vercel/front/pull/45417

- Improves the CSS content for clarity and brevity. 
- Adds Pages Router examples.

---------

Co-authored-by: Lee Robinson <[email protected]>
 2025-05-12 08:32:57 -05:00
Delba de OliveiraandGitHub 75658b8115 docs: Delete empty optimizing folder (#78966) 
Cleaning up 🧹
 2025-05-08 10:18:31 -05:00
Delba de OliveiraandGitHub 48e739089c Docs: Fix headings in Getting Started (#78965) 2025-05-08 16:06:15 +01:00
Delba de OliveiraGitHubRich Haines
 		3bf570d84d Docs IA 2.0: Images (#78769) 
Closes:
- https://linear.app/vercel/issue/DOC-4626/images
- https://linear.app/vercel/issue/DOC-4610/split-image-and-font-pages

Redirects: https://github.com/vercel/next.js/pull/78769

**Housekeeping:** 
- Deletes BYA images page
- Creates relevant getting started docs in `/pages`
- Splits "Images and Fonts" into "Images" and "Fonts" pages to allow us
to add more context to each page in the future

**API reference**: 
- Improves image API reference to follow more of a consistent format and
language
- Adds examples

**Follow-up:** https://github.com/vercel/next.js/pull/78857
- Create a Deep Dive Guide on how image optimization works

---------

Co-authored-by: Rich Haines <[email protected]>
 2025-05-08 13:11:38 +01:00
Delba de OliveiraandGitHub 6f4729effb docs: Create tailwind guide (#78908) 
Closes: https://linear.app/vercel/issue/DOC-4643/tailwind
Redirects: https://github.com/vercel/front/pull/45246
 2025-05-07 08:55:21 -05:00
Delba de OliveiraGitHubRich Haines
 		d05288de2e Docs IA 2.0: Metadata (#78905) 
Closes: https://linear.app/vercel/issue/DOC-4642/metadata
Redirects: https://github.com/vercel/front/pull/45244

- Expands `generateMetadata` API reference to describe behavior
- Adds new examples to the `ImageResponse` API reference
- Create JSON-LD guide

---------

Co-authored-by: Rich Haines <[email protected]>
 2025-05-07 11:58:32 +01:00
Delba de OliveiraandGitHub 6e3af1b0fe Docs IA 2.0: Fonts (#78899) 
Closes: https://linear.app/vercel/issue/DOC-4641/fonts
Redirects: https://github.com/vercel/front/pull/45242
 2025-05-07 10:09:12 +01:00
Delba de OliveiraGitHubLee Robinson
 		23d2441b3f docs: Improve landing page, add intro to Getting Started page (#78765) 
Co-authored-by: Lee Robinson <[email protected]>
 2025-05-02 11:38:00 -05:00
Delba de OliveiraandGitHub 071e31705f docs: Move caching page to deep dive (#78537) 
Closes: https://linear.app/vercel/issue/DOC-4608/caching
Redirects: https://github.com/vercel/front/pull/44626
 2025-04-25 10:51:30 -05:00
Delba de OliveiraandGitHub 354b255d91 docs: Move Sass and CSS-in-JS pages to guides (#78536) 2025-04-25 08:16:35 -05:00
Delba de OliveiraandGitHub 93a9e97c71 Docs IA 2.0: Create public folder API reference (#78531) 
Closes: https://linear.app/vercel/issue/DOC-4604/public-folder

- Renames "Static Assets" page to "Public Folder" and moves it to the
file-system conventions section.

Redirects: https://github.com/vercel/front/pull/44623
 2025-04-25 08:08:57 +01:00
Delba de OliveiraandGitHub 9e7c0991ee docs: Delete config page in app docs (#78521) 2025-04-24 14:08:34 -05:00
Delba de OliveiraandGitHub 76ade73def docs: Move optimizing pages to guides (#78500) 2025-04-24 13:40:54 -05:00
Delba de OliveiraandGitHub a0ab6d32af docs: Move src folder page to API reference (#78499) 2025-04-24 08:34:05 -05:00
Delba de OliveiraandGitHub 7a64ada1ab docs: Move pages from Config section into guides (#78496) 2025-04-24 07:28:50 -05:00
Delba de OliveiraandGitHub 7b554b3967 Docs IA 2.0: Move testing guides (#78418) 
Closes: https://linear.app/vercel/issue/DOC-4576/testing
Redirects: https://github.com/vercel/front/pull/44459
 2025-04-24 09:25:55 +01:00
Delba de OliveiraandGitHub bce5afe856 Docs IA 2.0: Move authentication page under guides (#78412) 
Closes: https://linear.app/vercel/issue/DOC-4574/authentication
Redirects: https://github.com/vercel/front/pull/44449
 2025-04-22 16:46:15 +01:00
Delba de OliveiraandGitHub 74d999e06d docs: Move CI build caching page under guides, and create equivalent /app guide (#78416) 
Closes: https://linear.app/vercel/issue/DOC-4577/ci-build-caching
Redirects: https://github.com/vercel/next.js/pull/78416
 2025-04-22 10:18:39 -05:00
Delba de OliveiraGitHubLee Robinson
 		d5359765dd docs: Move Static Exports to guides, create Self-hosting guide (#78244) 
Closes: 

- https://linear.app/vercel/issue/DOC-4550/static-exports
- https://linear.app/vercel/issue/DOC-4551/self-hosting

Redirects: https://github.com/vercel/front/pull/44237

---------

Co-authored-by: Lee Robinson <[email protected]>
 2025-04-22 08:44:58 -05:00
Delba de OliveiraandGitHub dd5f67f528 Docs: Fix nav item lettercasing for multi-zones (#78250) 2025-04-17 09:29:28 +01:00
Delba de OliveiraandGitHub 304c54ad74 docs: Move Production Checklist under Guides (#78240) 
Closes: https://linear.app/vercel/issue/DOC-4549/production-checklist
Redirects: https://github.com/vercel/front/pull/44234
 2025-04-16 19:10:35 -05:00
Delba de OliveiraandGitHub 3dc939b7fa Docs IA 2.0: Move multi-zones docs to Guides (#78238) 
Closes: https://linear.app/vercel/issue/DOC-4548/multi-zones
Redirects: https://github.com/vercel/front/pull/44233
 2025-04-16 14:11:41 +01:00
Delba de OliveiraGitHubRich Haines
 		49d1b5b330 Getting Started Docs: Add deploying page (#77720) 
Closes: https://linear.app/vercel/issue/DOC-3702/page-deploying

---------

Co-authored-by: Rich Haines <[email protected]>
 2025-04-16 12:50:37 +00:00
Delba de OliveiraandGitHub e3921c79ab Docs Papercuts (#78200) 
Closes: 

- https://vercel.slack.com/archives/C02F56A54LU/p1744661143046739
- https://vercel.slack.com/archives/C02F56A54LU/p1744120627226299
 2025-04-15 15:40:54 +00:00
Delba de OliveiraandGitHub bd0da32a68 Docs IA 2.0: Move migration docs under Guides (#78193) 
Closes: https://linear.app/vercel/issue/DOC-4540/migration-guides

Redirects: https://github.com/vercel/front/pull/44177

Please merge this one first:
https://github.com/vercel/next.js/pull/78189
 2025-04-15 15:39:01 +00:00
Delba de OliveiraandGitHub e5fe535ed1 Docs IA 2.0: Move SPA docs under Guides (#78195) 
Closes:
https://linear.app/vercel/issue/DOC-4541/single-page-applications-guides
Redirect: https://github.com/vercel/front/pull/44179
 2025-04-15 16:22:07 +01:00
Delba de OliveiraandGitHub ae1cad07dd Docs IA 2.0: Move version upgrade docs under Guides (#78189) 
Closes: https://linear.app/vercel/issue/DOC-4539/version-upgrade-guides

Redirects: https://github.com/vercel/front/pull/44175

Move version upgrade guides under `Guides`. Also creates a guides
section under the Pages docs.
 2025-04-15 16:00:54 +01:00
Delba de OliveiraandGitHub 59f7a8abe9 Getting Started Docs: Clean up docs/app and docs/pages pages (#78151) 
Closes: https://linear.app/vercel/issue/DOC-4498/clean-up-appdocs

- Went through the FAQ on the page and made sure the information is
found in other places in our docs.
- With the IA changes, we shouldn't need a FAQ that duplicates
information.
- We can have a dedicated App Router FAQ page in the future - if there's
a need for it.
 2025-04-15 09:20:52 +01:00
Delba de OliveiraandGitHub c94753cfdc Docs: Update useLinkStatus API reference (#78022) 
Updating the docs after playing around with `useLinkStatus`:
https://github.com/vercel/next-app-router-playground/pull/184
Closes: https://linear.app/vercel/issue/DOC-4514/update-docs

Main changes:

- Update introduction
- Simplify example
- Add example for gracefully handling fast navigations (avoiding UI
flash)
 2025-04-10 14:30:20 +01:00
Delba de OliveiraandGitHub 5b243a2d5a Docs: Improve "use cache" and cacheLife API references (#78024) 
Decoupling from: https://github.com/vercel/next.js/pull/73437


- Add "How `use cache` works" section
  - Clarify cache keys inputs
  - Describe what happens during build, runtime, and revalidation
- Correct the default values for the `cacheLife` profiles
- Add the default time for `expireTime`
- Add note about `staleTimes` and `expireTime` affecting the default
cache profile
 2025-04-10 14:26:26 +01:00
Delba de OliveiraGitHubSebastian Sebbie Silbermann
 		d8aae5e7c0 15.3 Docs: Turbopack for build (#77730) 
Closes: https://linear.app/vercel/issue/DOC-4469/turbopack-for-builds

---------

Co-authored-by: Sebastian "Sebbie" Silbermann <[email protected]>
 2025-04-10 11:17:41 +01:00
Delba de OliveiraandGitHub 97ad23fb00 IA 2.0: Add "Next Steps" link to /docs landing page (#77981) 
Closes:
https://linear.app/vercel/issue/DOC-4500/fix-links-in-the-landing-page
 2025-04-09 12:05:52 -05:00
Delba de OliveiraandGitHub cfad624df1 docs: update Getting Started Section (#77921) 
Closes: https://linear.app/vercel/issue/DOC-4467/review-and-clean-up

Also addressed user feedback from vercel/feedback
 2025-04-08 08:08:41 -05:00
Delba de OliveiraandGitHub 6bc472a788 Docs IA 2.0: Add Deep Dive section placeholder (#77724) 
This section will be for developers who want to understand how things
work. It's not essential knowledge, but good to know.

A place for conceptual information and colorful diagrams that explain
the magic behind things ✨ 🌈
 2025-04-04 16:24:56 +01:00
Delba de OliveiraandGitHub 251d1fec82 Revert "Docs: Recommend inline use server and update examples" (#77771) 
Reverts vercel/next.js#77770
 2025-04-03 12:35:46 +01:00
Delba de OliveiraandGitHub d9d3f73fbc Docs: Recommend inline use server and update examples (#77770) 2025-04-03 12:05:12 +01:00
Delba de OliveiraandGitHub 9249188ebb Docs IA 2.0: Rename Examples to Guides (#77722) 
Examples: small, isolated use cases
Guides: more extensive how-tos

Redirect: https://github.com/vercel/front/pull/43551
 2025-04-02 14:57:01 +01:00
Delba de OliveiraGitHubRich Haines
 		48eac4d5d1 Getting Started Docs: Add Upgrade page (#77717) 
Closes: https://linear.app/vercel/issue/DOC-4072/page-upgrading

---------

Co-authored-by: Rich Haines <[email protected]>
 2025-04-02 14:09:50 +01:00
Delba de OliveiraGitHubRich Haines
 		0a5e04220a Getting Started Docs: Add Metadata and OG images page (#74077) 
Closes:
https://linear.app/vercel/issue/DOC-3701/page-metadata-and-og-images

- Default fields
- Static metadata
- Generated metadata
- Favicons
- Static OG images
- Generated OG images

---------

Co-authored-by: Rich Haines <[email protected]>
 2025-04-02 13:35:02 +01:00
Delba de OliveiraandGitHub 8986037d33 15.2 docs: document missing htmlLimitedBots option (#76616) 
- Minor updates to the new Streaming Metadata section
- Document new next.config.ts option: `htmlLimitedBots`
 2025-02-27 17:33:59 +00:00
Delba de OliveiraandGitHub 8df92f1d2f 15.2: Add version history for devIndicators and note on deprecated options (#76611) 
We added a new option to `devIndicators` (`position`) and removed the
previous options from the docs. This PR adds a version history with a
note about the deprecated options.
 2025-02-27 17:00:48 +00:00
Delba de OliveiraandGitHub 4b443ec82a Delete expirePath and expireTag pages (again) (#75691) 
Context: https://vercel.slack.com/archives/C02F56A54LU/p1738675938419809
 2025-02-10 16:33:46 +00:00
Delba de OliveiraandGitHub a016ea3e9c Getting Started docs: Consistent casing and naming (#74637) 2025-01-27 06:40:11 -06:00
Delba de OliveiraandGitHub c527168d7e Getting Started docs: Add Error Handling page (#74069) 
Closes: https://linear.app/vercel/issue/DOC-4077/page-handling-errors
 2025-01-06 08:41:17 -06:00
Delba de OliveiraGitHubLee Robinson
 		67ac8bfdb2 Getting Started Docs: Add Mutating Data page (#74018) 
Closes: https://linear.app/vercel/issue/DOC-3906/page-mutating-data

---------

Co-authored-by: Lee Robinson <[email protected]>
 2025-01-06 08:40:11 -06:00
Delba de OliveiraandGitHub 484e5b1d23 Docs: fix typo in examples page (#73907) 
Fix typo in examples page
 2024-12-15 14:34:12 -06:00
Delba de OliveiraandGitHub 7a124bc0dc Docs clean up: delete defining-routes.mdx and pages.mdx (#73863) 
Please merge this PR first: https://github.com/vercel/next.js/pull/73859

Closes: 

-
https://linear.app/vercel/issue/DOC-4050/delete-routingdefining-routesmdx
- https://linear.app/vercel/issue/DOC-4051/delete-routingpagesmdx

The content for this page has already been moved to the Getting Started
section or API Reference.
 2024-12-13 13:29:26 +00:00
Delba de OliveiraGitHubRich Haines
 		26e8b765ae Docs clean up: Merge and delete content from routing/index.mdx (#73859) 
Please merge this PR first: https://github.com/vercel/next.js/pull/73858

Closes: https://linear.app/vercel/issue/DOC-4049/delete-routingindexmdx

The content for this page has already been moved to the `Getting
Started` section or `API Reference`.

---------

Co-authored-by: Rich Haines <[email protected]>
 2024-12-13 13:16:26 +00:00
Delba de OliveiraandGitHub 67921c23ef Docs: Create Examples section (#73858) 
Closes: https://linear.app/vercel/issue/DOC-4047/create-examples-section

Redirects: https://github.com/vercel/front/pull/39878
 2024-12-13 12:08:44 +00:00
Delba de OliveiraandGitHub 349e3ce4d6 Docs: Remove unstable_expirePath and unstable_expireTag docs (#73856) 
These APIs are under development and haven't been announced. We are not
recommending people use it yet.

CloseS:
https://linear.app/vercel/issue/DOC-4038/remove-the-unstable-expiretag-and-unstable-expirepath-docs-as-the
Context: https://vercel.slack.com/archives/C06DGJ420TZ/p1733916966674099
Redirects: https://github.com/vercel/front/pull/39875
 2024-12-13 11:40:24 +00:00
Delba de OliveiraGitHubLee Robinson
 		bf1b6a65eb 15.1 docs: stable after (#73038) 
**Do not merge until stable `after` lands in canary (#73605).** 

Closes: https://linear.app/vercel/issue/DOC-3818/[stable]-nextafter
Redirect: https://github.com/vercel/front/pull/38704

---------

Co-authored-by: Lee Robinson <[email protected]>
 2024-12-10 14:35:53 +00:00
Delba de OliveiraandGitHub b097d10515 15.1 docs: Add experimental tags to forbidden and unauthorized APIs (#73513) 
**Do not merge until 15.1 is released.** 

Currently these features are tagged as `canary`, but once 15.1 becomes
stable, they'll be `experimental`.

Closes:
https://linear.app/vercel/issue/DOC-3928/update-forbidden-docs-to-add-experimental-tag
 2024-12-10 14:15:37 +00:00
Delba de OliveiraandGitHub f8d7facdd8 Docs: Getting Started Nits (#73596) 
Going through the getting started pages with fresh eyes, picked up some
nits.
 2024-12-10 13:34:29 +00:00
Delba de OliveiraandGitHub b730b9c0d2 15.1 docs: request APIs in after (#73692) 
Closes:
https://linear.app/vercel/issue/DOC-3929/allow-request-apis-in-after

Adds example for using request APIs in `after`.
Adds note about Server Component restriction. 

related: https://github.com/vercel/next.js/pull/73345
 2024-12-10 11:47:43 +00:00
Delba de OliveiraandGitHub bb4ddae93e Docs: Add canary page to upgrade guides (#73518) 
Closes:
https://linear.app/vercel/issue/DOC-3933/add-canary-docs-page-to-keep-track-of-features
 2024-12-09 12:17:38 +00:00
Delba de OliveiraGitHubLee Robinson
 		030fe51eba 15.1 docs: React 19 (#73510) 
Closes: 

- https://linear.app/vercel/issue/DOC-3927/react-19-stable
-
https://linear.app/vercel/issue/DOC-3931/update-mentions-of-useformstate-to-useactionstate-for-react-19-stable

This PR updates the docs for React 19 stable. 

- Reviews docs for mentions of React 19 canary
- Updates mentions of `useFormState` to `userActionState`
- Reviews mentions of `useFormStatus`, improves example

---------

Co-authored-by: Lee Robinson <[email protected]>
 2024-12-09 12:10:04 +00:00