Unverified Commit 2b76ed70 authored by Delba de Oliveira's avatar Delba de Oliveira Committed by GitHub

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: 's avatargraphite-app[bot] <96075541+graphite-app[bot]@users.noreply.github.com>
parent 2ecfdb8b
--- ---
title: How to set up a new Next.js project title: Installation
nav_title: Installation description: Learn how to create a new Next.js application with the `create-next-app` CLI, and set up TypeScript, ESLint, and Module Path Aliases.
description: Create a new Next.js application with the `create-next-app` CLI, and set up TypeScript, ESLint, and Module Path Aliases.
--- ---
{/* The content of this doc is shared between the app and pages router. You can use the `<PagesOnly>Content</PagesOnly>` component to add content that is specific to the Pages Router. Any shared content should not be wrapped in a component. */} {/* The content of this doc is shared between the app and pages router. You can use the `<PagesOnly>Content</PagesOnly>` component to add content that is specific to the Pages Router. Any shared content should not be wrapped in a component. */}
......
--- ---
title: Project structure and organization title: Project structure and organization
nav_title: Project Structure nav_title: Project Structure
description: An overview of the folder and file conventions in Next.js, and how to organize your project. description: Learn the folder and file conventions in Next.js, and how to organize your project.
--- ---
This page provides an overview of **all** the folder and file conventions in Next.js, and recommendations for organizing your project. This page provides an overview of **all** the folder and file conventions in Next.js, and recommendations for organizing your project.
......
--- ---
title: How to create layouts and pages title: Layouts and Pages
nav_title: Layouts and Pages description: Learn how to create your first pages and layouts, and link between them with the Link component.
description: Create your first pages and layouts, and link between them.
related: related:
title: API Reference title: API Reference
description: Learn more about the features mentioned in this page by reading the API Reference. description: Learn more about the features mentioned in this page by reading the API Reference.
......
--- ---
title: Linking and Navigating title: Linking and Navigating
description: Learn how prefetching, prerendering, and client-side navigation works in Next.js, and how to use the Link Component. description: Learn how the built-in navigation optimizations work, including prefetching, prerendering, and client-side navigation, and how to optimize navigation for dynamic routes and slow networks.
related: related:
links: links:
- app/api-reference/components/link - app/api-reference/components/link
- app/api-reference/file-conventions/loading - app/api-reference/file-conventions/loading
- app/guides/prefetching
--- ---
In Next.js, routes are rendered on the server by default. This often means the client has to wait for a server response before a new route can be shown. Next.js comes built-in [prefetching](#prefetching), [streaming](#streaming), and [client-side transitions](#client-side-transitions) ensuring navigation stays fast and responsive. In Next.js, routes are rendered on the server by default. This often means the client has to wait for a server response before a new route can be shown. Next.js comes built-in [prefetching](#prefetching), [streaming](#streaming), and [client-side transitions](#client-side-transitions) ensuring navigation stays fast and responsive.
......
--- ---
title: How to use Server and Client Components title: Server and Client Components
nav_title: Server and Client Components
description: Learn how you can use React Server and Client Components to render parts of your application on the server or the client. description: Learn how you can use React Server and Client Components to render parts of your application on the server or the client.
related: related:
title: Next Steps title: Next Steps
......
--- ---
title: How to use Partial Prerendering title: Partial Prerendering
nav_title: Partial Prerendering description: Learn how to use Partial Prerendering and combine the benefits of static and dynamic rendering.
description: Learn how to combine the benefits of static and dynamic rendering with Partial Prerendering.
version: experimental version: experimental
related: related:
title: Next Steps title: Next Steps
......
--- ---
title: How to fetch data and stream title: Fetching Data and Streaming
nav_title: Fetching Data description: Learn how to fetch data and stream content that depends on data.
description: Start fetching data and streaming content in your application.
related: related:
title: API Reference title: API Reference
description: Learn more about the features mentioned in this page by reading the API Reference. description: Learn more about the features mentioned in this page by reading the API Reference.
links: links:
- app/guides/data-security
- app/api-reference/functions/fetch - app/api-reference/functions/fetch
- app/api-reference/file-conventions/loading - app/api-reference/file-conventions/loading
- app/api-reference/config/next-config-js/logging - app/api-reference/config/next-config-js/logging
......
--- ---
title: How to update data title: Updating data
nav_title: Updating Data description: Learn how to mutate data using Server Functions.
description: Learn how to update data in your Next.js application.
related: related:
title: API Reference title: API Reference
description: Learn more about the features mentioned in this page by reading the API Reference. description: Learn more about the features mentioned in this page by reading the API Reference.
......
--- ---
title: How to handle errors title: Error Handling
nav_title: Error Handling
description: Learn how to display expected errors and handle uncaught exceptions. description: Learn how to display expected errors and handle uncaught exceptions.
related: related:
title: API Reference title: API Reference
......
--- ---
title: How to cache and revalidate data title: Caching and Revalidating
nav_title: Caching and Revalidating
description: Learn how to cache and revalidate data in your application. description: Learn how to cache and revalidate data in your application.
related: related:
title: API Reference title: API Reference
......
--- ---
title: How to use CSS in your application title: CSS
nav_title: CSS
description: Learn about the different ways to add CSS to your application, including CSS Modules, Global CSS, Tailwind CSS, and more. description: Learn about the different ways to add CSS to your application, including CSS Modules, Global CSS, Tailwind CSS, and more.
related: related:
title: Next Steps title: Next Steps
......
--- ---
title: How to optimize images title: Image Optimization
nav_title: Images
description: Learn how to optimize images in Next.js description: Learn how to optimize images in Next.js
related: related:
title: API Reference title: API Reference
......
--- ---
title: How to use fonts title: Font Optimization
nav_title: Fonts description: Learn how to optimize fonts in Next.js
description: Learn how to use fonts in Next.js
related: related:
title: API Reference title: API Reference
description: See the API Reference for the full feature set of Next.js Font description: See the API Reference for the full feature set of Next.js Font
......
--- ---
title: How to add metadata and create OG images title: Metadata and OG images
nav_title: Metadata and OG images
description: Learn how to add metadata to your pages and create dynamic OG images. description: Learn how to add metadata to your pages and create dynamic OG images.
related: related:
title: API Reference title: API Reference
......
--- ---
title: How to deploy your Next.js application title: Deploying
nav_title: Deploying
description: Learn how to deploy your Next.js application. description: Learn how to deploy your Next.js application.
--- ---
......
--- ---
title: How to upgrade your Next.js app title: Upgrading
nav_title: Upgrading description: Learn how to upgrade your Next.js application to the latest version or canary.
description: Learn how to upgrade your Next.js application to the latest version.
related: related:
title: Version guides title: Version guides
description: See the version guides for in-depth upgrade instructions. description: See the version guides for in-depth upgrade instructions.
......
--- ---
title: Guides title: Guides
description: Learn how to implement common UI patterns and use cases using Next.js description: Learn how to implement common patterns and real-world use cases using Next.js
--- ---
### Data Fetching
- [Using the `fetch` API](/docs/app/getting-started/fetching-data#with-the-fetch-api)
- [Using an ORM or database client](/docs/app/getting-started/fetching-data#with-an-orm-or-database)
- [Reading search params on the server](/docs/app/api-reference/file-conventions/page)
- [Reading search params on the client](/docs/app/api-reference/functions/use-search-params)
### Revalidating Data
- [Using ISR to revalidate data after a certain time](/docs/app/guides/incremental-static-regeneration#time-based-revalidation)
- [Using ISR to revalidate data on-demand](/docs/app/guides/incremental-static-regeneration#on-demand-revalidation-with-revalidatepath)
### Forms
- [Showing a pending state while submitting a form](/docs/app/guides/forms)
- [Server-side form validation](/docs/app/guides/forms)
- [Handling expected errors](/docs/app/getting-started/error-handling#handling-expected-errors)
- [Handling unexpected exceptions](/docs/app/getting-started/error-handling#handling-uncaught-exceptions)
- [Showing optimistic UI updates](/docs/app/guides/forms#optimistic-updates)
- [Programmatic form submission](/docs/app/guides/forms#programmatic-form-submission)
### Server Actions
- [Passing additional values](/docs/app/guides/forms)
- [Revalidating data](/docs/app/getting-started/updating-data#revalidating)
- [Redirecting](/docs/app/guides/redirecting)
- [Setting cookies](/docs/app/api-reference/functions/cookies#setting-a-cookie)
- [Deleting cookies](/docs/app/api-reference/functions/cookies#deleting-cookies)
### Metadata
- [Creating an RSS feed](/docs/app/api-reference/file-conventions/route#non-ui-responses)
- [Creating an Open Graph image](/docs/app/api-reference/file-conventions/metadata/opengraph-image)
- [Creating a sitemap](/docs/app/api-reference/file-conventions/metadata/sitemap)
- [Creating a robots.txt file](/docs/app/api-reference/file-conventions/metadata/robots)
- [Creating a custom 404 page](/docs/app/api-reference/file-conventions/not-found)
- [Creating a custom 500 page](/docs/app/api-reference/file-conventions/error)
### Auth
- [Creating a sign-up form](/docs/app/guides/authentication#sign-up-and-login-functionality)
- [Stateless, cookie-based session management](/docs/app/guides/authentication#stateless-sessions)
- [Stateful, database-backed session management](/docs/app/guides/authentication#database-sessions)
- [Managing authorization](/docs/app/guides/authentication#authorization)
### Testing
- [Vitest](/docs/app/guides/testing/vitest)
- [Jest](/docs/app/guides/testing/jest)
- [Playwright](/docs/app/guides/testing/playwright)
- [Cypress](/docs/app/guides/testing/cypress)
### Deployment
- [Creating a Dockerfile](/docs/app/getting-started/deploying#docker)
- [Creating a static export (SPA)](/docs/app/guides/static-exports)
- [Configuring caching when self-hosting](/docs/app/guides/self-hosting#configuring-caching)
- [Configuring Image Optimization when self-hosting](/docs/app/guides/self-hosting#image-optimization)
--- ---
title: Form title: Form Component
description: Learn how to use the `<Form>` component to handle form submissions and search params updates with client-side navigation. description: Learn how to use the `<Form>` component to handle form submissions and search params updates with client-side navigation.
--- ---
......
--- ---
title: Image title: Image Component
description: Optimize Images in your Next.js Application using the built-in `next/image` Component. description: Optimize Images in your Next.js Application using the built-in `next/image` Component.
--- ---
......
--- ---
title: Link title: Link Component
description: Enable fast client-side navigation with the built-in `next/link` component. description: Enable fast client-side navigation with the built-in `next/link` component.
--- ---
......
--- ---
title: Script title: Script Component
description: Optimize third-party scripts in your Next.js application using the built-in `next/script` Component. description: Optimize third-party scripts in your Next.js application using the built-in `next/script` Component.
--- ---
......
--- ---
title: Introduction title: Next.js Docs
description: Welcome to the Next.js Documentation. description: Welcome to the Next.js Documentation.
related: related:
title: Next Steps title: Next Steps
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment