From cfcb22ef2644e4ec6bbb831e4e6935f94d51760c Mon Sep 17 00:00:00 2001
From: anandgupta42 <anand@altimate.ai>
Date: Tue, 3 Mar 2026 11:48:45 -0800
Subject: [PATCH] docs: reorganize sidebar navigation for better
 discoverability

- Remove navigation.expand so sub-sections start collapsed (less overwhelming)
- Group Configure's 16 flat items into 5 logical sub-sections:
  Providers & Models, Agents & Tools, Behavior, Appearance, Integrations
- Group orphaned bottom pages (Network, Troubleshooting, Windows/WSL) under Reference
- All 44 pages preserved, zero information lost

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 docs/mkdocs.yml | 45 +++++++++++++++++++++++++--------------------
 1 file changed, 25 insertions(+), 20 deletions(-)

diff --git a/docs/mkdocs.yml b/docs/mkdocs.yml
index 8c07079910..dac5104260 100644
--- a/docs/mkdocs.yml
+++ b/docs/mkdocs.yml
@@ -30,7 +30,6 @@ theme:
         name: Switch to light mode
   features:
     - navigation.sections
-    - navigation.expand
     - navigation.top
     - search.suggest
     - search.highlight
@@ -56,22 +55,27 @@ nav:
       - GitHub: usage/github.md
       - GitLab: usage/gitlab.md
   - Configure:
-      - Configuration: configure/config.md
-      - Providers: configure/providers.md
-      - Tools: configure/tools.md
-      - Rules: configure/rules.md
-      - Agents: configure/agents.md
-      - Models: configure/models.md
-      - Themes: configure/themes.md
-      - Keybinds: configure/keybinds.md
-      - Commands: configure/commands.md
-      - Formatters: configure/formatters.md
-      - Permissions: configure/permissions.md
-      - LSP Servers: configure/lsp.md
-      - MCP Servers: configure/mcp-servers.md
-      - ACP Support: configure/acp.md
-      - Agent Skills: configure/skills.md
-      - Custom Tools: configure/custom-tools.md
+      - Overview: configure/config.md
+      - Providers & Models:
+          - Providers: configure/providers.md
+          - Models: configure/models.md
+      - Agents & Tools:
+          - Agents: configure/agents.md
+          - Tools: configure/tools.md
+          - Agent Skills: configure/skills.md
+          - Custom Tools: configure/custom-tools.md
+          - Commands: configure/commands.md
+      - Behavior:
+          - Rules: configure/rules.md
+          - Permissions: configure/permissions.md
+          - Formatters: configure/formatters.md
+      - Appearance:
+          - Themes: configure/themes.md
+          - Keybinds: configure/keybinds.md
+      - Integrations:
+          - LSP Servers: configure/lsp.md
+          - MCP Servers: configure/mcp-servers.md
+          - ACP Support: configure/acp.md
   - Data Engineering:
       - Agent Modes: data-engineering/agent-modes.md
       - Tools:
@@ -93,6 +97,7 @@ nav:
       - Server: develop/server.md
       - Plugins: develop/plugins.md
       - Ecosystem: develop/ecosystem.md
-  - Network: network.md
-  - Troubleshooting: troubleshooting.md
-  - Windows / WSL: windows-wsl.md
+  - Reference:
+      - Network: network.md
+      - Troubleshooting: troubleshooting.md
+      - Windows / WSL: windows-wsl.md