docs(astro-docs): reorganize Learn Nx sidebar structure

- Simplify getting started flow: Introduction → Start New → Add Existing → Local Dev
- Merge editor-setup and ai-setup into single local-development page
- Add global install preamble to start-new-project and start-with-existing-project
- Move nx-cloud intro to guides/Nx Cloud section
- Move install-non-javascript to reference section
- Move update-global-installation to troubleshooting section
- Curate Concepts section to only include core concepts:
  - Mental Model, How Caching Works, Task Pipelines, Inferred Tasks, Nx Plugins
- Update all internal links to reflect new page locations

URL changes requiring redirects:
- /docs/getting-started/installation → /docs/getting-started/start-new-project
- /docs/getting-started/editor-setup → /docs/getting-started/local-development
- /docs/getting-started/ai-setup → /docs/getting-started/local-development
- /docs/getting-started/nx-cloud → /docs/guides/nx-cloud/intro
- /docs/guides/installation/install-non-javascript → /docs/reference/install-non-javascript
- /docs/guides/installation/update-global-installation → /docs/troubleshooting/update-global-installation

Author: barbados-clemens

astro-docs/URL_REDIRECTS.md

@@ -0,0 +1,60 @@
+# URL Redirects Tracking
+
+This file tracks URL changes that need redirects configured in the deployment platform (Netlify).
+
+## Learn Nx Reorganization (DOC-365)
+
+Date: 2024-12-19
+
+### Redirects Required
+
+| Old URL                                                | New URL                                            | Status  |
+| ------------------------------------------------------ | -------------------------------------------------- | ------- |
+| `/docs/getting-started/installation`                   | `/docs/getting-started/start-new-project`          | Pending |
+| `/docs/getting-started/editor-setup`                   | `/docs/getting-started/local-development`          | Pending |
+| `/docs/getting-started/ai-setup`                       | `/docs/getting-started/local-development`          | Pending |
+| `/docs/getting-started/nx-cloud`                       | `/docs/guides/nx-cloud/intro`                      | Pending |
+| `/docs/guides/installation/install-non-javascript`     | `/docs/reference/install-non-javascript`           | Pending |
+| `/docs/guides/installation/update-global-installation` | `/docs/troubleshooting/update-global-installation` | Pending |
+
+### Notes
+
+- All redirects should be 301 (permanent) redirects
+- Configure in `netlify.toml` or Netlify dashboard
+- Test redirects after deployment to ensure they work correctly
+
+### Netlify Configuration Example
+
+```toml
+# Add to netlify.toml
+
+[[redirects]]
+  from = "/docs/getting-started/installation"
+  to = "/docs/getting-started/start-new-project"
+  status = 301
+
+[[redirects]]
+  from = "/docs/getting-started/editor-setup"
+  to = "/docs/getting-started/local-development"
+  status = 301
+
+[[redirects]]
+  from = "/docs/getting-started/ai-setup"
+  to = "/docs/getting-started/local-development"
+  status = 301
+
+[[redirects]]
+  from = "/docs/getting-started/nx-cloud"
+  to = "/docs/guides/nx-cloud/intro"
+  status = 301
+
+[[redirects]]
+  from = "/docs/guides/installation/install-non-javascript"
+  to = "/docs/reference/install-non-javascript"
+  status = 301
+
+[[redirects]]
+  from = "/docs/guides/installation/update-global-installation"
+  to = "/docs/troubleshooting/update-global-installation"
+  status = 301
+```

astro-docs/sidebar.mts

@@ -9,9 +9,7 @@ export const sidebar: StarlightUserConfig['sidebar'] = [
     label: 'Learn Nx',
     collapsed: false,
     items: [
-      // Getting Started - flattened
-      { label: 'Why Nx?', link: 'getting-started/intro' },
-      { label: 'Installation', link: 'getting-started/installation' },
+      { label: 'Introduction', link: 'getting-started/intro' },
       {
         label: 'Start a New Project',
         link: 'getting-started/start-new-project',
@@ -20,16 +18,9 @@ export const sidebar: StarlightUserConfig['sidebar'] = [
         label: 'Add to Existing Project',
         link: 'getting-started/start-with-existing-project',
       },
-      { label: 'Editor Setup', link: 'getting-started/editor-setup' },
-      { label: 'AI Setup', link: 'getting-started/ai-setup' },
-      { label: 'Nx Cloud Intro', link: 'getting-started/nx-cloud' },
       {
-        label: 'Install in Non-JS Repo',
-        link: 'guides/installation/install-non-javascript',
-      },
-      {
-        label: 'Update Global Installation',
-        link: 'guides/installation/update-global-installation',
+        label: 'Local Development',
+        link: 'getting-started/local-development',
       },
       {
         label: 'Tutorials',
@@ -40,9 +31,18 @@ export const sidebar: StarlightUserConfig['sidebar'] = [
         },
       },
       {
-        label: 'Core Concepts',
+        label: 'Concepts',
         collapsed: true,
-        autogenerate: { directory: 'concepts', collapsed: true },
+        items: [
+          { label: 'Mental Model', link: 'concepts/mental-model' },
+          { label: 'How Caching Works', link: 'concepts/how-caching-works' },
+          {
+            label: 'Task Pipelines',
+            link: 'concepts/task-pipeline-configuration',
+          },
+          { label: 'Inferred Tasks', link: 'concepts/inferred-tasks' },
+          { label: 'Nx Plugins', link: 'concepts/nx-plugins' },
+        ],
       },
     ],
   },

astro-docs/src/content/docs/extending-nx/local-executors.mdoc

@@ -4,7 +4,7 @@ description: Learn how to create, run, and customize local executors in your Nx
 filter: 'type:Guides'
 ---
 
-Creating Executors for your workspace standardizes scripts that are run during your development/building/deploying tasks in order to provide guidance in the terminal with `--help` and when invoking with [Nx Console](/docs/getting-started/editor-setup)
+Creating Executors for your workspace standardizes scripts that are run during your development/building/deploying tasks in order to provide guidance in the terminal with `--help` and when invoking with [Nx Console](/docs/getting-started/local-development)
 
 This guide shows you how to create, run, and customize executors within your Nx workspace. The examples use the trivial use-case of an `echo` command.
 

astro-docs/src/content/docs/extending-nx/organization-specific-plugin.mdoc

@@ -133,7 +133,7 @@ export interface LibraryGeneratorSchema {
 The `schema.d.ts` file is used for type checking inside the implementation file. It should match the properties in `schema.json`.
 {% /aside %}
 
-The schema files not only provide structure to the CLI, but also allow [Nx Console](/docs/getting-started/editor-setup) to show an accurate UI for the generator.
+The schema files not only provide structure to the CLI, but also allow [Nx Console](/docs/getting-started/local-development) to show an accurate UI for the generator.
 
 ![Nx Console UI for the library generator](../../../assets/nx-console/generator-options-ui.png)
 

astro-docs/src/content/docs/features/CI Features/self-healing-ci.mdoc

@@ -314,7 +314,7 @@ You will see the notification about an available fix from Nx Cloud directly in y
 
 {% tabitem label="In your editor" %}
 
-If you have [Nx Console](/docs/getting-started/editor-setup) installed, you'll get a notification directly in your editor:
+If you have [Nx Console](/docs/getting-started/local-development) installed, you'll get a notification directly in your editor:
 
 ![Notification in your editor about an AI fix](../../../../assets/features/notification-self-healing-ci.avif)
 
@@ -356,7 +356,7 @@ Review the Git diff directly in the comment and click "Apply fix" or "Reject fix
 
 {% tabitem label="In your editor" %}
 
-With [Nx Console](/docs/getting-started/editor-setup) installed, open the dedicated CI view which will show you the fix details as well as the buttons to apply, apply locally or reject the fix.
+With [Nx Console](/docs/getting-started/local-development) installed, open the dedicated CI view which will show you the fix details as well as the buttons to apply, apply locally or reject the fix.
 
 ![Apply the fix directly from within Nx Console](../../../../assets/features/self-healing-apply-nx-console.avif)
 

astro-docs/src/content/docs/features/automate-updating-dependencies.mdoc

@@ -25,7 +25,7 @@ npx nx@latest migrate latest
 ```
 
 {% aside type="note" title="Visual migration tool from Nx Console" %}
-Want a more visual and guided way to migrate? Check out the [Migrate UI](/docs/guides/nx-console/console-migrate-ui) that comes with the [Nx Console extension](/docs/getting-started/editor-setup).
+Want a more visual and guided way to migrate? Check out the [Migrate UI](/docs/guides/nx-console/console-migrate-ui) that comes with the [Nx Console extension](/docs/getting-started/local-development).
 {% /aside %}
 
 ## How Does It Work?

astro-docs/src/content/docs/features/cache-task-results.mdoc

@@ -171,7 +171,7 @@ To view the task settings that have been automatically configured by a plugin, u
 nx show project <project-name> --web
 ```
 
-Alternatively, you can view these directly in your editor by installing [Nx Console](/docs/getting-started/editor-setup).
+Alternatively, you can view these directly in your editor by installing [Nx Console](/docs/getting-started/local-development).
 
 Learn more details about [Nx plugins](/docs/concepts/nx-plugins) and [inferred tasks](/docs/concepts/inferred-tasks).
 

astro-docs/src/content/docs/features/enhance-AI.mdoc

@@ -22,7 +22,7 @@ The goal is to transform your AI assistant from a generic code helper into an ar
 
 ## How Nx MCP Enhances Your LLM
 
-The [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) is an open standard that enables AI models to interact with your development environment through a standardized interface. Nx implements an MCP server via the [Nx Console](/docs/getting-started/editor-setup) that exposes workspace metadata to compatible AI assistants like GitHub Copilot, Claude, and others.
+The [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) is an open standard that enables AI models to interact with your development environment through a standardized interface. Nx implements an MCP server via the [Nx Console](/docs/getting-started/local-development) that exposes workspace metadata to compatible AI assistants like GitHub Copilot, Claude, and others.
 
 With the Nx MCP server, your AI assistant gains a "map" of your entire system being able to go from just reasoning at the file level to seeing the higher-level picture. This allows the LLM to move between different abstraction levels - from high-level architecture down to specific implementation details:
 
@@ -44,7 +44,7 @@ This configures Nx Console which automatically configures and serves the Nx MCP
 
 For VS Code, Cursor, and JetBrains IDE users:
 
-1. Install [Nx Console](/docs/getting-started/editor-setup) from the marketplace
+1. Install [Nx Console](/docs/getting-started/local-development) from the marketplace
 2. You'll receive a notification to "Improve Copilot/AI agent with Nx-specific context"
 3. Click "Yes" to configure the MCP server
 

astro-docs/src/content/docs/features/explore-graph.mdoc

@@ -25,7 +25,7 @@ This guide will teach you to use this tool to explore projects, the project grap
 Projects in Nx are the different parts of the monorepo which can have tasks run for them.
 
 The best way to see what projects are in your workspace is to view the [project graph](#explore-the-project-graph) which will be covered in the next section.
-Another way is to look at the **Projects** pane in [Nx Console](/docs/getting-started/editor-setup) or run `nx show projects` to show a list of projects in your terminal.
+Another way is to look at the **Projects** pane in [Nx Console](/docs/getting-started/local-development) or run `nx show projects` to show a list of projects in your terminal.
 
 You can see more details about a specific project in Nx Console or by running `nx show project <project-name> --web`. Both methods will show something like the example below:
 
@@ -280,7 +280,7 @@ It always stays up to date without having to actively maintain a document as it
 
 ### Launching the Project Graph
 
-To launch the project graph visualization for your workspace, use [Nx Console](/docs/getting-started/editor-setup) or run:
+To launch the project graph visualization for your workspace, use [Nx Console](/docs/getting-started/local-development) or run:
 
 ```shell
 npx nx graph

astro-docs/src/content/docs/features/generate-code.mdoc

@@ -40,11 +40,11 @@ nx list @nx/react
 
 ### Use Nx Console
 
-If you prefer a visual interface, then [Nx Console](/docs/getting-started/editor-setup) is an excellent alternative. It provides a way to visually find and run generators:
+If you prefer a visual interface, then [Nx Console](/docs/getting-started/local-development) is an excellent alternative. It provides a way to visually find and run generators:
 
 ![Using Nx Console to run generators](../../../assets/nx-console/nx-console-gen-code.avif)
 
-Nx Console is an IDE extension that can be [installed here](/docs/getting-started/editor-setup).
+Nx Console is an IDE extension that can be [installed here](/docs/getting-started/local-development).
 
 ## Build Your Own Generator