Reorganize top-level sections in a more logical way

Author: guilherme-gm

.github/workflows/docs.yml

@@ -12,7 +12,7 @@ jobs:
     steps:
       - uses: actions/checkout@v3
       - run: python -m pip install --upgrade pip
-      - run: pip install mkdocs mkdocs-material
+      - run: pip install mkdocs mkdocs-material mkdocs-awesome-pages-plugin
       - run: pip install -e ./hercscript-lexer
       - run: cd docs
       - run: mkdocs build -f mkdocs.yml

docs/.pages

@@ -0,0 +1,11 @@
+nav:
+    - index.md
+    - about
+    - basics
+    - overview
+    - setup
+    - customization
+    - scripting
+    - client
+    - contributing
+    - ...

mkdocs.yml

@@ -62,3 +62,6 @@ theme:
       toggle:
         icon: material/brightness-4
         name: Switch to system preference
+plugins:
+  - search
+  - awesome-pages