From ea71f5e8e9e7761a4bc000aa2b22f4477aa9606b Mon Sep 17 00:00:00 2001 From: Aguru Sireesha Date: Tue, 30 Sep 2025 23:08:30 +0530 Subject: [PATCH 1/4] docs(project-structure): fix Oxford comma, heading case, pluralization, and not-found description; improve microcopy MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit PR title docs: polish Project Structure page (grammar, consistency, clarity) PR description Fixes an Oxford comma in the routing files description for consistency. Normalizes heading capitalization to sentence case. Corrects “Files conventions” → “File conventions”. Aligns not-found.js description with earlier table (it’s not an error boundary). Clarifies intercepting routes microcopy. --- .../02-project-structure.mdx | 22 +++++++++---------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/docs/01-app/01-getting-started/02-project-structure.mdx b/docs/01-app/01-getting-started/02-project-structure.mdx index e4c18f191c016c..3623c0ca4cf645 100644 --- a/docs/01-app/01-getting-started/02-project-structure.mdx +++ b/docs/01-app/01-getting-started/02-project-structure.mdx @@ -52,7 +52,7 @@ Top-level files are used to configure your application, manage dependencies, run ### Routing Files -Add `page` to expose a route, `layout` for shared UI such as header, nav, or footer, `loading` for skeletons, `error` for error boundaries and `route` for APIs. +Add `page` to expose a route, `layout` for shared UI such as header, nav, or footer, `loading` for skeletons, `error` for error boundaries, and `route` for APIs. | | | | | ----------------------------------------------------------------------------- | ------------------- | ---------------------------- | @@ -88,7 +88,7 @@ Parameterize segments with square brackets. Use `[segment]` for a single param, | `app/shop/[...slug]/page.tsx` | `/shop/clothing`, `/shop/clothing/shirts` | | `app/docs/[[...slug]]/page.tsx` | `/docs`, `/docs/layouts-and-pages`, `/docs/api-reference/use-router` | -### Route Groups and private folders +### Route groups and private folders Organize code without changing URLs with route groups [`(group)`](/docs/app/api-reference/file-conventions/route-groups#convention), and colocate non-routable files with private folders [`_folder`](#private-folders). @@ -105,13 +105,13 @@ These features fit specific UI patterns, such as slot-based layouts or modal rou Use `@slot` for named slots rendered by a parent layout. Use intercept patterns to render another route inside the current layout without changing the URL, for example, to show a details view as a modal over a list. -| Pattern (docs) | Meaning | Typical use case | -| ------------------------------------------------------------------------------------------- | -------------------- | ------------------------------------ | -| [`@folder`](/docs/app/api-reference/file-conventions/parallel-routes#slots) | Named slot | Sidebar + main content | -| [`(.)folder`](/docs/app/api-reference/file-conventions/intercepting-routes#convention) | Intercept same level | Preview sibling route in a modal | -| [`(..)folder`](/docs/app/api-reference/file-conventions/intercepting-routes#convention) | Intercept parent | Open parent child as overlay | -| [`(..)(..)folder`](/docs/app/api-reference/file-conventions/intercepting-routes#convention) | Intercept two levels | Deeply nested overlay | -| [`(...)folder`](/docs/app/api-reference/file-conventions/intercepting-routes#convention) | Intercept from root | Show arbitrary route in current view | +| Pattern (docs) | Meaning | Typical use case | +| ------------------------------------------------------------------------------------------- | -------------------- | ------------------------------------ | +| [`@folder`](/docs/app/api-reference/file-conventions/parallel-routes#slots) | Named slot | Sidebar + main content | +| [`(.)folder`](/docs/app/api-reference/file-conventions/intercepting-routes#convention) | Intercept same level | Preview sibling route in a modal | +| [`(..)folder`](/docs/app/api-reference/file-conventions/intercepting-routes#convention) | Intercept parent | Open a child of the parent as an overlay | +| [`(..)(..)folder`](/docs/app/api-reference/file-conventions/intercepting-routes#convention) | Intercept two levels | Deeply nested overlay | +| [`(...)folder`](/docs/app/api-reference/file-conventions/intercepting-routes#convention) | Intercept from root | Show arbitrary route in current view | ### Metadata file conventions @@ -147,7 +147,7 @@ Use `@slot` for named slots rendered by a parent layout. Use intercept patterns -### Files conventions +### File conventions | | | | | ----------------------------------------------------------------------------------------------------------- | ------------------- | ----------------- | @@ -197,7 +197,7 @@ The components defined in special files are rendered in a specific hierarchy: - `template.js` - `error.js` (React error boundary) - `loading.js` (React suspense boundary) -- `not-found.js` (React error boundary) +- `not-found.js` (Not found UI) - `page.js` or nested `layout.js` Date: Wed, 1 Oct 2025 00:00:07 +0530 Subject: [PATCH 2/4] docs: fix Prettier formatting --- .../01-getting-started/02-project-structure.mdx | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/01-app/01-getting-started/02-project-structure.mdx b/docs/01-app/01-getting-started/02-project-structure.mdx index 3623c0ca4cf645..02ba205a4dac53 100644 --- a/docs/01-app/01-getting-started/02-project-structure.mdx +++ b/docs/01-app/01-getting-started/02-project-structure.mdx @@ -105,13 +105,13 @@ These features fit specific UI patterns, such as slot-based layouts or modal rou Use `@slot` for named slots rendered by a parent layout. Use intercept patterns to render another route inside the current layout without changing the URL, for example, to show a details view as a modal over a list. -| Pattern (docs) | Meaning | Typical use case | -| ------------------------------------------------------------------------------------------- | -------------------- | ------------------------------------ | -| [`@folder`](/docs/app/api-reference/file-conventions/parallel-routes#slots) | Named slot | Sidebar + main content | -| [`(.)folder`](/docs/app/api-reference/file-conventions/intercepting-routes#convention) | Intercept same level | Preview sibling route in a modal | -| [`(..)folder`](/docs/app/api-reference/file-conventions/intercepting-routes#convention) | Intercept parent | Open a child of the parent as an overlay | -| [`(..)(..)folder`](/docs/app/api-reference/file-conventions/intercepting-routes#convention) | Intercept two levels | Deeply nested overlay | -| [`(...)folder`](/docs/app/api-reference/file-conventions/intercepting-routes#convention) | Intercept from root | Show arbitrary route in current view | +| Pattern (docs) | Meaning | Typical use case | +| ------------------------------------------------------------------------------------------- | -------------------- | ---------------------------------------- | +| [`@folder`](/docs/app/api-reference/file-conventions/parallel-routes#slots) | Named slot | Sidebar + main content | +| [`(.)folder`](/docs/app/api-reference/file-conventions/intercepting-routes#convention) | Intercept same level | Preview sibling route in a modal | +| [`(..)folder`](/docs/app/api-reference/file-conventions/intercepting-routes#convention) | Intercept parent | Open a child of the parent as an overlay | +| [`(..)(..)folder`](/docs/app/api-reference/file-conventions/intercepting-routes#convention) | Intercept two levels | Deeply nested overlay | +| [`(...)folder`](/docs/app/api-reference/file-conventions/intercepting-routes#convention) | Intercept from root | Show arbitrary route in current view | ### Metadata file conventions From 80018b6e19b74c1ec6b9c7abf0b09ebb25fdf6ac Mon Sep 17 00:00:00 2001 From: Aguru Sireesha Date: Wed, 1 Oct 2025 16:50:10 +0530 Subject: [PATCH 3/4] docs: improve not-found.js description --- docs/01-app/01-getting-started/02-project-structure.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/01-app/01-getting-started/02-project-structure.mdx b/docs/01-app/01-getting-started/02-project-structure.mdx index 02ba205a4dac53..94f2f8e2729f56 100644 --- a/docs/01-app/01-getting-started/02-project-structure.mdx +++ b/docs/01-app/01-getting-started/02-project-structure.mdx @@ -197,7 +197,7 @@ The components defined in special files are rendered in a specific hierarchy: - `template.js` - `error.js` (React error boundary) - `loading.js` (React suspense boundary) -- `not-found.js` (Not found UI) +- `not-found.js` (Error boundary for "not found" state) - `page.js` or nested `layout.js` Date: Wed, 1 Oct 2025 20:45:31 +0530 Subject: [PATCH 4/4] docs: updated not-found.js description --- docs/01-app/01-getting-started/02-project-structure.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/01-app/01-getting-started/02-project-structure.mdx b/docs/01-app/01-getting-started/02-project-structure.mdx index 94f2f8e2729f56..917c733e2928ec 100644 --- a/docs/01-app/01-getting-started/02-project-structure.mdx +++ b/docs/01-app/01-getting-started/02-project-structure.mdx @@ -197,7 +197,7 @@ The components defined in special files are rendered in a specific hierarchy: - `template.js` - `error.js` (React error boundary) - `loading.js` (React suspense boundary) -- `not-found.js` (Error boundary for "not found" state) +- `not-found.js` (React error boundary for "not found" UI) - `page.js` or nested `layout.js`