number sections and document sidebar ordering

docs/content/02-features/index.md

@@ -2,7 +2,7 @@
 
 Archivox automatically turns your Markdown files into a full documentation site with a responsive layout and search.
 
-* Sidebar navigation generated from folders
+* Sidebar navigation generated from folders (prefix names with numbers to control order)
 * Collapsible mobile menu and dark-mode switch
 * Client-side search powered by Lunr.js
 * Shortcodes for rich content (images, tabs, notes)

docs/content/02-features/navigation.md

@@ -0,0 +1,14 @@
+# Controlling Sidebar Order
+
+Archivox builds the sidebar by scanning the `content/` directory. Folders and files are sorted alphabetically by default. To set a custom order, prefix the names with numbers like `01-` or `02-`.
+
+```
+content/
+  01-getting-started/
+    01-install.md
+    02-build.md
+  02-features/
+  03-customization/
+```
+
+Numbers are stripped from the displayed titles, but they determine the ordering in the navigation. Nested folders work the same way, letting you create subsections within a section.