Unverified Commit 23d2441b authored by Delba de Oliveira's avatar Delba de Oliveira Committed by GitHub

docs: Improve landing page, add intro to Getting Started page (#78765)

Co-authored-by: 's avatarLee Robinson <lee@leerob.com>
parent a4fff794
...@@ -2,3 +2,20 @@ ...@@ -2,3 +2,20 @@
title: Getting Started title: Getting Started
description: Learn how to create full-stack web applications with the Next.js App Router. description: Learn how to create full-stack web applications with the Next.js App Router.
--- ---
Welcome to the Next.js documentation!
This **Getting Started** section will help you create your first Next.js app and learn the core features you'll use in every project.
## Pre-requisite knowledge
Our documentation assumes some familiarity with web development. Before getting started, it'll help if you're comfortable with:
- HTML
- CSS
- JavaScript
- React
If you're new to React or need a refresher, we recommend starting with our [React Foundations course](/learn/react-foundations), and the [Next.js Foundations course](/learn/dashboard-app) that has you building an application as you learn.
## Next Steps
...@@ -3,9 +3,9 @@ title: Introduction ...@@ -3,9 +3,9 @@ title: Introduction
description: Welcome to the Next.js Documentation. description: Welcome to the Next.js Documentation.
related: related:
title: Next Steps title: Next Steps
description: Get started with Next.js by following the installation guide. description: Create your first application and learn the core Next.js features.
links: links:
- app/getting-started/installation - app/getting-started
--- ---
Welcome to the Next.js documentation! Welcome to the Next.js documentation!
...@@ -14,48 +14,44 @@ Welcome to the Next.js documentation! ...@@ -14,48 +14,44 @@ Welcome to the Next.js documentation!
Next.js is a React framework for building full-stack web applications. You use React Components to build user interfaces, and Next.js for additional features and optimizations. Next.js is a React framework for building full-stack web applications. You use React Components to build user interfaces, and Next.js for additional features and optimizations.
Under the hood, Next.js also abstracts and automatically configures tooling needed for React, like bundling, compiling, and more. This allows you to focus on building your application instead of spending time with configuration. It also automatically configures lower-level tools like bundlers and compilers. You can instead focus on building your product and shipping quickly.
Whether you're an individual developer or part of a larger team, Next.js can help you build interactive, dynamic, and fast React applications. Whether you're an individual developer or part of a larger team, Next.js can help you build interactive, dynamic, and fast React applications.
## Main Features ## How to use the docs
Some of the main Next.js features include: The docs are organized into 4 sections:
| Feature | Description | - [Getting Started](/docs/app/getting-started): Step-by-step tutorials to help you create a new application and learn the core Next.js features.
| ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | - [Guides](/docs/app/guides): Tutorials on specific use cases, choose what's relevant to you.
| [Routing](/docs/app/building-your-application/routing) | A file-system based router built on top of Server Components that supports layouts, nested routing, loading states, error handling, and more. | - [Deep Dive](/docs/app/deep-dive): In-depth explanations on how Next.js works.
| [Rendering](/docs/app/building-your-application/rendering) | Client-side and Server-side Rendering with Client and Server Components. Further optimized with Static and Dynamic Rendering on the server with Next.js. Streaming on Edge and Node.js runtimes. | - [API Reference](/docs/app/api-reference): Detailed technical reference for every feature.
| [Data Fetching](/docs/app/building-your-application/data-fetching) | Simplified data fetching with async/await in Server Components, and an extended `fetch` API for request memoization, data caching and revalidation. |
| [Styling](/docs/app/building-your-application/styling) | Support for your preferred styling methods, including CSS Modules, Tailwind CSS, and CSS-in-JS |
| [Optimizations](/docs/app/building-your-application/optimizing) | Image, Fonts, and Script Optimizations to improve your application's Core Web Vitals and User Experience. |
| [TypeScript](/docs/app/api-reference/config/typescript) | Improved support for TypeScript, with better type checking and more efficient compilation, as well as custom TypeScript Plugin and type checker. |
## How to Use These Docs Use the sidebar to navigate through the sections, or search (`Ctrl+K` or `Cmd+K`) to quickly find a page.
On the left side of the screen, you'll find the docs navbar. The pages of the docs are organized sequentially, from basic to advanced, so you can follow them step-by-step when building your application. However, you can read them in any order or skip to the pages that apply to your use case. ## App Router and Pages Router
On the right side of the screen, you'll see a table of contents that makes it easier to navigate between sections of a page. If you need to quickly find a page, you can use the search bar at the top, or the search shortcut (`Ctrl+K` or `Cmd+K`). Next.js has two different routers:
To get started, check out the [Installation](/docs/app/getting-started/installation) guide. - **App Router**: The newer router that supports new React features like Server Components.
- **Pages Router**: The original router, still supported and being improved.
## App Router vs Pages Router At the top of the sidebar, you'll notice a dropdown menu that allows you to switch between the [App Router](/docs/app) and the [Pages Router](/docs/pages) docs.
Next.js has two different routers: the App Router and the Pages Router. The App Router is a newer router that allows you to use React's latest features, such as Server Components and Streaming. The Pages Router is the original Next.js router, which allowed you to build server-rendered React applications and continues to be supported for older Next.js applications. ## Pre-requisite knowledge
At the top of the sidebar, you'll notice a dropdown menu that allows you to switch between the **App Router** and the **Pages Router** features. Since there are features that are unique to each directory, it's important to keep track of which tab is selected. Our documentation assumes some familiarity with web development. Before getting started, it'll help if you're comfortable with:
The breadcrumbs at the top of the page will also indicate whether you're viewing App Router docs or Pages Router docs. - HTML
- CSS
- JavaScript
- React
## Pre-Requisite Knowledge If you're new to React or need a refresher, we recommend starting with our [React Foundations course](/learn/react-foundations), and the [Next.js Foundations course](/learn/dashboard-app) that has you building an application as you learn.
Although our docs are designed to be beginner-friendly, we need to establish a baseline so that the docs can stay focused on Next.js functionality. We'll make sure to provide links to relevant documentation whenever we introduce a new concept.
To get the most out of our docs, it's recommended that you have a basic understanding of HTML, CSS, and React. If you need to brush up on your React skills, check out our [React Foundations Course](/learn/react-foundations), which will introduce you to the fundamentals. Then, learn more about Next.js by [building a dashboard application](/learn/dashboard-app).
## Accessibility ## Accessibility
For optimal accessibility when using a screen reader while reading the docs, we recommend using Firefox and NVDA, or Safari and VoiceOver. For the best experience when using a screen reader, we recommend using Firefox and NVDA, or Safari and VoiceOver.
## Join our Community ## Join our Community
......
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