Restructure documentation navbar for improved navigation

This commit reorganizes the documentation structure to better utilize
the navbar and improve user experience:

**Navbar Changes:**
- Split single "Tutorial" dropdown into three focused sections:
  - "Get Started" - Beginner onboarding (6 pages)
  - "Guides" - How-to guides and examples (21 pages)
  - "Reference" - Commands, troubleshooting, and lookup materials (20+ pages)

**Sidebar Restructuring:**
- Created gettingStartedSidebar with essential quick-start content
- Created guidesSidebar organized into:
  - Core Concepts
  - Advanced Techniques
  - Build Type Examples
  - CI/CD Integration
- Created referenceSidebar with:
  - Command Reference (auto-generated)
  - Reference Materials
  - Troubleshooting
  - Code of Conduct

**Content Updates:**
- Streamlined intro.md (Quick Start page) by replacing detailed
  documentation guide with focused "Next Steps" section
- Updated footer links to reflect new structure
- Improved information architecture for faster content discovery

**Benefits:**
- Command reference now accessible in 2 clicks vs deep sidebar navigation
- Clear separation between learning content and lookup content
- Reduced cognitive load with focused, purposeful sections
- Better SEO through improved content organization
- No breaking changes - all URLs remain valid

Author: claude

docs/intro.md

@@ -101,46 +101,13 @@ to orchestrate their build process.
 * [ICU4N](https://github.com/NightOwl888/ICU4N)
 * [RandomizedTesting](https://github.com/NightOwl888/RandomizedTesting)
 
-## Documentation Guide
+## Next Steps
 
-### Getting Started
+Ready to start using psake? Here's what to do next:
 
-New to psake? Start here:
+1. **[Install psake](/docs/tutorial-basics/installing)** - Get psake set up on your system
+2. **[Run your first build](/docs/tutorial-basics/run-psake)** - Create and execute your first psake script
+3. **[Explore the Guides](/docs/tutorial-basics/default-build-files)** - Learn best practices and advanced techniques
+4. **[Check the Command Reference](/docs/commands/Invoke-psake)** - Look up specific commands and their parameters
 
-- **[Installing psake](/docs/tutorial-basics/installing)** - Installation methods and prerequisites
-- **[Running psake](/docs/tutorial-basics/run-psake)** - Your first psake build
-- **[Tasks](/docs/tutorial-basics/tasks)** - Understanding tasks and dependencies
-- **[Parameters and Properties](/docs/tutorial-basics/parameters-properties)** - Configuring your builds
-
-### Build Type Examples
-
-Learn how to use psake with different project types:
-
-- **[.NET Solutions](/docs/build-types/dot-net-solution)** - Building .NET projects with MSBuild
-- **[Node.js Projects](/docs/build-types/nodejs)** - npm, TypeScript, and Webpack builds
-- **[Docker Builds](/docs/build-types/docker)** - Building and publishing Docker images
-
-### CI/CD Integration
-
-Integrate psake with your CI/CD pipeline:
-
-- **[GitHub Actions](/docs/ci-examples/github-actions)** - Complete GitHub Actions setup
-- **[Azure Pipelines](/docs/ci-examples/azure-pipelines)** - Azure DevOps integration
-- **[GitLab CI](/docs/ci-examples/gitlab-ci)** - GitLab CI/CD configuration
-
-### Troubleshooting
-
-Having issues? Check these resources:
-
-- **[Common Errors](/docs/troubleshooting/common-errors)** - Solutions to frequent problems
-- **[FAQ](/docs/troubleshooting/faq)** - Frequently asked questions
-- **[Debugging Guide](/docs/troubleshooting/debugging-guide)** - Debugging build scripts
-
-### Reference
-
-Quick reference and comprehensive documentation:
-
-- **[Glossary](/docs/reference/glossary)** - Definitions of psake terms and concepts
-- **[Cheat Sheet](/docs/reference/cheat-sheet)** - Quick reference for common patterns
-- **[Configuration Reference](/docs/reference/configuration-reference)** - All configuration options
-- **[Exit Codes](/docs/reference/exit-codes)** - Understanding exit codes in CI/CD
+Need help? Visit our [Troubleshooting](/docs/troubleshooting/common-errors) section or join the [PowerShell Discord](https://aka.ms/psdiscord) #psake channel.

docusaurus.config.ts

@@ -82,9 +82,21 @@ const config: Config = {
       items: [
         {
           type: 'docSidebar',
-          sidebarId: 'tutorialSidebar',
+          sidebarId: 'gettingStartedSidebar',
           position: 'left',
-          label: 'Tutorial',
+          label: 'Get Started',
+        },
+        {
+          type: 'docSidebar',
+          sidebarId: 'guidesSidebar',
+          position: 'left',
+          label: 'Guides',
+        },
+        {
+          type: 'docSidebar',
+          sidebarId: 'referenceSidebar',
+          position: 'left',
+          label: 'Reference',
         },
         { to: '/blog', label: 'Blog', position: 'left' },
         {
@@ -101,16 +113,16 @@ const config: Config = {
           title: 'Docs',
           items: [
             {
-              label: 'Quick Start',
+              label: 'Get Started',
               to: '/docs/intro',
             },
             {
-              label: 'Tutorial - Basics',
-              to: '/docs/tutorial-basics/installing',
+              label: 'Guides',
+              to: '/docs/tutorial-basics/default-build-files',
             },
             {
               label: 'Command Reference',
-              to: '/docs/commands/Assert',
+              to: '/docs/commands/Invoke-psake',
             },
             {
               label: 'Code of Conduct',

sidebars.ts

@@ -1,5 +1,6 @@
 import type { SidebarsConfig } from '@docusaurus/plugin-content-docs';
 import commands from "./docs/commands/docusaurus.sidebar.js";
+
 /**
  * Creating a sidebar enables you to:
  - create an ordered group of docs
@@ -11,26 +12,31 @@ import commands from "./docs/commands/docusaurus.sidebar.js";
  Create as many sidebars as you want.
  */
 const sidebars: SidebarsConfig = {
-  // By default, Docusaurus generates a sidebar from the docs folder structure
-  tutorialSidebar: [
+  // Getting Started - For newcomers and quick onboarding
+  gettingStartedSidebar: [
     'intro',
+    'tutorial-basics/installing',
+    'tutorial-basics/getting-help',
+    'tutorial-basics/run-psake',
+    'tutorial-basics/tasks',
+    'tutorial-basics/parameters-properties',
+  ],
+
+  // Guides - How-to guides, examples, and best practices
+  guidesSidebar: [
     {
       type: 'category',
-      label: 'Tutorial - Basics',
+      label: 'Core Concepts',
       items: [
-        'tutorial-basics/installing',
-        'tutorial-basics/getting-help',
-        'tutorial-basics/run-psake',
-        'tutorial-basics/tasks',
-        'tutorial-basics/parameters-properties',
         'tutorial-basics/default-build-files',
         'tutorial-basics/how-to-fail-a-build',
         'tutorial-basics/nested-build',
+        'tutorial-advanced/structure-of-a-psake-build-script',
       ],
     },
     {
       type: 'category',
-      label: 'Tutorial - Advanced',
+      label: 'Advanced Techniques',
       items: [
         'tutorial-advanced/access-functions-in-another-file',
         'tutorial-advanced/build-script-resilience',
@@ -39,13 +45,12 @@ const sidebars: SidebarsConfig = {
         'tutorial-advanced/outputs-and-artifacts',
         'tutorial-advanced/print-psake-task-name',
         'tutorial-advanced/retry-rules',
-        'tutorial-advanced/structure-of-a-psake-build-script',
         'tutorial-advanced/variable-referencing',
       ],
     },
     {
       type: 'category',
-      label: 'Build Types',
+      label: 'Build Type Examples',
       items: [
         'build-types/dot-net-solution',
         'build-types/nodejs',
@@ -54,7 +59,7 @@ const sidebars: SidebarsConfig = {
     },
     {
       type: 'category',
-      label: 'CI Examples',
+      label: 'CI/CD Integration',
       items: [
         'ci-examples/github-actions',
         'ci-examples/azure-pipelines',
@@ -64,28 +69,32 @@ const sidebars: SidebarsConfig = {
         'ci-examples/team-city',
       ]
     },
+  ],
+
+  // Reference - Command reference, troubleshooting, and lookup materials
+  referenceSidebar: [
     {
       type: 'category',
       label: 'Command Reference',
       items: commands
     },
     {
       type: 'category',
-      label: 'Troubleshooting',
+      label: 'Reference Materials',
       items: [
-        'troubleshooting/common-errors',
-        'troubleshooting/faq',
-        'troubleshooting/debugging-guide',
+        'reference/configuration-reference',
+        'reference/cheat-sheet',
+        'reference/glossary',
+        'reference/exit-codes',
       ]
     },
     {
       type: 'category',
-      label: 'Reference',
+      label: 'Troubleshooting',
       items: [
-        'reference/glossary',
-        'reference/cheat-sheet',
-        'reference/configuration-reference',
-        'reference/exit-codes',
+        'troubleshooting/common-errors',
+        'troubleshooting/faq',
+        'troubleshooting/debugging-guide',
       ]
     },
     {
@@ -94,19 +103,6 @@ const sidebars: SidebarsConfig = {
       id: 'code_of_conduct'
     },
   ],
-
-  // But you can create a sidebar manually
-  /*
-  tutorialSidebar: [
-    'intro',
-    'hello',
-    {
-      type: 'category',
-      label: 'Tutorial',
-      items: ['tutorial-basics/create-a-document'],
-    },
-  ],
-   */
 };
 
 export default sidebars;