Add sections to main docs

docs/_static/custom.css

@@ -3,8 +3,18 @@
 
 
 :root {
-  font-feature-settings: 'liga' 1, 'calt' 1; /* fix for Chrome */
+  font-feature-settings: 'liga' 1, 'calt' 1;
+  /* fix for Chrome */
 }
+
 @supports (font-variation-settings: normal) {
-  :root { font-family: InterVariable, sans-serif; }
+  :root {
+    font-family: InterVariable, sans-serif;
+  }
 }
+
+
+/* Hide ToC caption text within the main body (but leave them in the side-bar). */
+#furo-main-content span.caption-text {
+  display: none;
+}

docs/index.md

@@ -32,6 +32,7 @@ If anything seems confusing, don't hesitate to have a look at our {doc}`glossary
 
 ```{toctree}
 :maxdepth: 2
+:caption: Basics
 
 getting-started
 bound-loggers
@@ -48,6 +49,8 @@ exceptions
 
 ```{toctree}
 :maxdepth: 2
+:caption: Development Affordances
+
 console-output
 testing
 typing
@@ -63,6 +66,7 @@ Dedicated support for the standard library and Twisted is shipped out-of-the-box
 
 ```{toctree}
 :maxdepth: 2
+:caption: Integrations
 
 frameworks
 standard-library
@@ -77,6 +81,7 @@ The following chapters deal with considerations of using *structlog* in the real
 
 ```{toctree}
 :maxdepth: 2
+:caption: In Practice
 
 recipes
 logging-best-practices
@@ -88,28 +93,25 @@ performance
 
 ```{toctree}
 :maxdepth: 2
+:caption: Reference
 
 api
 glossary
+genindex
+modindex
 ```
 
 
 ## Deprecated Features
 
 ```{toctree}
 :maxdepth: 1
+:caption: Deprecated Features
 
 thread-local
 ```
 
 
-## Indices and tables
-
-- {any}`genindex`
-- {any}`modindex`
-- {any}`glossary`
-
-
 ```{toctree}
 :hidden:
 :caption: Meta