From 6e0c185b42f2791c7e911fe3829087a51d7dc427 Mon Sep 17 00:00:00 2001
From: John Barker <john@johnrbarker.com>
Date: Sun, 26 Jul 2026 16:27:52 +0100
Subject: [PATCH] fix(mkdocs): integrate TOC into sidebar and add missing nav
 pages

Enable mkdocs-material theme features to match Navigator's docsite
sidebar behavior (fixes #19). Add 5 doc files that were missing from
the nav configuration.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 mkdocs.yml | 21 ++++++++++++++++++---
 1 file changed, 18 insertions(+), 3 deletions(-)

diff --git a/mkdocs.yml b/mkdocs.yml
index a84c0e1..0430814 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -11,13 +11,28 @@ strict: true
 
 theme:
   name: 'ansible'
+  features:
+    - content.code.copy
+    - content.action.edit
+    - navigation.expand
+    - navigation.sections
+    - navigation.instant
+    - navigation.indexes
+    - navigation.tracking
+    - toc.integrate
 
 nav:
   - Home: 'index.md'
-  - 'License': 'license.md'
-  - 'community_guide.md'
-  - 'user_guide.md'
+  - Installation: 'installing.md'
+  - Getting started: 'getting_started_user.md'
+  - User guide:
+    - 'user_guide.md'
+    - 'user_guide/how_to_xxx.md'
   - 'contributor_guide.md'
   - 'maintainer_guide.md'
+  - 'community_guide.md'
   - References:
     - 'references/cli.md'
+    - 'references/porting_guide.md'
+    - 'references/roadmap.md'
+  - 'License': 'license.md'