docs(misc): replace monolithic tutorials with focused topic-based tutorials

astro-docs/netlify.toml

@@ -36,6 +36,24 @@ to = "/docs/quickstart"
 from = "/showcase/benchmarks/*"
 to = "/docs/reference/benchmarks/:splat"
 
+# DOC-452: Old framework tutorials redirect to new topic-based tutorials
+[[redirects]]
+from = "/docs/getting-started/tutorials/react-monorepo-tutorial"
+to = "/docs/getting-started/tutorials/crafting-your-workspace"
+
+[[redirects]]
+from = "/docs/getting-started/tutorials/angular-monorepo-tutorial"
+to = "/docs/getting-started/tutorials/crafting-your-workspace"
+
+[[redirects]]
+from = "/docs/getting-started/tutorials/typescript-packages-tutorial"
+to = "/docs/getting-started/tutorials/crafting-your-workspace"
+
+# DOC-452: Learn Nx URLs redirect to Tutorials (in case any were indexed)
+[[redirects]]
+from = "/docs/getting-started/learn-nx/*"
+to = "/docs/getting-started/tutorials/:splat"
+
 # Fix broken /docs/ paths still linked from CLI/Cloud source code (DOC-428)
 [[redirects]]
 from = "/docs/features/ci-features/self-healing"

astro-docs/sidebar.mts

@@ -37,28 +37,45 @@ const learnGroups: SidebarItems = [
       { label: 'Editor setup', link: 'getting-started/editor-setup' },
       {
         label: 'Tutorials',
-        collapsed: false,
+        badge: 'New',
+        collapsed: true,
         items: [
           {
-            label: 'React monorepo',
-            link: 'getting-started/tutorials/react-monorepo-tutorial',
+            label: 'Crafting your workspace',
+            link: 'getting-started/tutorials/crafting-your-workspace',
           },
           {
-            label: 'Angular monorepo',
-            link: 'getting-started/tutorials/angular-monorepo-tutorial',
+            label: 'Managing dependencies',
+            link: 'getting-started/tutorials/managing-dependencies',
           },
           {
-            label: 'TypeScript monorepo',
-            link: 'getting-started/tutorials/typescript-packages-tutorial',
+            label: 'Configuring tasks',
+            link: 'getting-started/tutorials/configuring-tasks',
           },
           {
-            label: 'Gradle monorepo',
-            link: 'getting-started/tutorials/gradle-tutorial',
+            label: 'Running tasks',
+            link: 'getting-started/tutorials/running-tasks',
+          },
+          {
+            label: 'Caching tasks',
+            link: 'getting-started/tutorials/caching',
+          },
+          {
+            label: 'Understanding your workspace',
+            link: 'getting-started/tutorials/understanding-your-workspace',
+          },
+          {
+            label: 'Reduce boilerplate',
+            link: 'getting-started/tutorials/reducing-configuration-boilerplate',
           },
           {
             label: 'Setting up CI',
             link: 'getting-started/tutorials/self-healing-ci-tutorial',
           },
+          {
+            label: 'Gradle monorepo',
+            link: 'getting-started/tutorials/gradle-tutorial',
+          },
         ],
       },
     ],

astro-docs/src/content/docs/concepts/how-caching-works.mdoc

@@ -214,6 +214,10 @@ npx nx build footer
 
 ## Next steps
 
+{% aside type="tip" title="Learn by doing" %}
+Try the [Caching](/docs/getting-started/tutorials/caching) tutorial to apply these concepts in your own workspace.
+{% /aside %}
+
 Learn more about how to configure caching, where the cache is stored, how to reset it and more.
 
 - [Cache Task Results](/docs/features/cache-task-results)

astro-docs/src/content/docs/concepts/inferred-tasks.mdoc

@@ -338,6 +338,10 @@ More details about how to override task configuration is available in these guid
 
 ## Existing Nx workspaces
 
+{% aside type="tip" title="Learn by doing" %}
+Try the [Reducing Configuration Boilerplate](/docs/getting-started/tutorials/reducing-configuration-boilerplate) tutorial to apply these concepts in your own workspace.
+{% /aside %}
+
 If you have an existing Nx Workspace and upgrade to the latest Nx version, a migration will automatically set `useInferencePlugins` to `false` in `nx.json`. This property allows you to continue to use Nx without inferred tasks.
 
 When `useInferencePlugins` is `false`:

astro-docs/src/content/docs/concepts/nx-plugins.mdoc

@@ -24,5 +24,9 @@ For example, plugins can accomplish the following:
 
 ## Types of plugins
 
+{% aside type="tip" title="Learn by doing" %}
+Try the [Reducing Configuration Boilerplate](/docs/getting-started/tutorials/reducing-configuration-boilerplate) tutorial to apply these concepts in your own workspace.
+{% /aside %}
+
 {% linkcard title="Official and Community Plugins" href="/docs/plugin-registry" description="Browse the plugin registry to discover plugins created by the Nx core team and the community" /%}
 {% linkcard title="Build Your Own Plugin" href="/docs/extending-nx/organization-specific-plugin" description="Build your own plugin to use internally or share with the community" /%}

astro-docs/src/content/docs/concepts/task-pipeline-configuration.mdoc

@@ -97,4 +97,8 @@ These rules can be defined globally in the `nx.json` file or locally per project
 
 ## Configure it for your own project
 
+{% aside type="tip" title="Learn by doing" %}
+Try the [Configuring Tasks](/docs/getting-started/tutorials/configuring-tasks) tutorial to apply these concepts in your own workspace.
+{% /aside %}
+
 Learn about all the details of how to configure [task pipelines in the according recipe section](/docs/guides/tasks--caching/defining-task-pipeline).

astro-docs/src/content/docs/concepts/types-of-configuration.mdoc

@@ -50,5 +50,9 @@ repo/
 
 ## More information
 
+{% aside type="tip" title="Learn by doing" %}
+Try the [Configuring Tasks](/docs/getting-started/tutorials/configuring-tasks) tutorial to apply these concepts in your own workspace.
+{% /aside %}
+
 - [Nx Configuration](/docs/reference/nx-json)
 - [Project Configuration](/docs/reference/project-configuration)