Fix auto-expanding of subsections

gtjoseph · gtjoseph · commit 2b8f688f1fd1 · 2025-11-05T07:33:22.000-07:00
diff --git a/docs/Configuration/.pages b/docs/Configuration/.pages
@@ -1,4 +1,5 @@
 nav:
+  - index.md
   - Core-Configuration
   - Channel-Drivers
   - Dialplan
diff --git a/docs/Configuration/Channel-Drivers/.pages b/docs/Configuration/Channel-Drivers/.pages
@@ -1,4 +1,5 @@
 nav:
+  - index.md
   - SIP
   - DAHDI.md
   - Inter-Asterisk-eXchange-protocol-version-2-IAX2
diff --git a/docs/Configuration/Interfaces/.pages b/docs/Configuration/Interfaces/.pages
@@ -1,4 +1,5 @@
 nav:
+  - index.md
   - Asterisk-Manager-Interface-AMI
   - Asterisk-REST-Interface-ARI
   - Asterisk-Gateway-Interface-AGI.md
diff --git a/docs/Contributing-to-the-Documentation.md b/docs/Contributing-to-the-Documentation.md
@@ -107,7 +107,19 @@ nav:
   - Page-3.md
 ```
 
-Each entry must be a name as it appears in the filesystem.  Only list what you want to appear in the left sidebar.  Don't list supporting files like images and don't list `index.md` files.
+Each entry must be a name as it appears in the filesystem.  Only list what you want to appear in the left sidebar.  Don't list supporting files like images.
+
+/// note
+The plugin that handles the .pages files has an annoying habit of automatically expanding the first item in the nav list which can be very confusing to the user. So, if the first entry is a directory and you don't want it automatically expanded, make the `index.md` file the first entry.  It won't show up in the sidebar but it'll keep the first section from auto-expanding.
+
+```yaml title="Sample .pages file"
+nav:
+  - index.md  # Keeps Section-1 from auto-expanding
+  - Section-1
+  - Page-2.md
+```
+
+///
 
 ### Deleting, renaming or moving pages or sections
 
diff --git a/docs/Deployment/Basic-PBX-Functionality/.pages b/docs/Deployment/Basic-PBX-Functionality/.pages
@@ -1,4 +1,5 @@
 nav:
+  - index.md
   - The-Most-Basic-PBX.md
   - Registering-Phones-to-Asterisk.md
   - Creating-Dialplan-Extensions.md
diff --git a/docs/Getting-Started/Installing-Asterisk/.pages b/docs/Getting-Started/Installing-Asterisk/.pages
@@ -1,4 +1,5 @@
 nav:
+  - index.md
   - Installing-Asterisk-From-Source
   - Alternate-Install-Methods
   - Installing-Asterisk-on-Non-Linux-Operating-Systems
diff --git a/docs/Getting-Started/Installing-Asterisk/Installing-Asterisk-From-Source/.pages b/docs/Getting-Started/Installing-Asterisk/Installing-Asterisk-From-Source/.pages
@@ -1,4 +1,5 @@
 nav:
+  - index.md
   - What-to-Download
   - Prerequisites
   - Using-Menuselect-to-Select-Asterisk-Options.md

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,5 @@`
`1`	`1`	`nav:`
	`2`	`+ - index.md`
`2`	`3`	`- Core-Configuration`
`3`	`4`	`- Channel-Drivers`
`4`	`5`	`- Dialplan`