Table of Content improvements

srittau · srittau · commit 53c0526a5117 · 2025-07-16T16:17:15.000+02:00
* Remove extra top levels from main ToC.
* Don't include sub-chapters of the specification in the main ToC.
* Reduce the ToC level by one on the guides index.
diff --git a/docs/guides/index.rst b/docs/guides/index.rst
@@ -1,9 +1,14 @@
+:orphan:
+
 ******************
 Type System Guides
 ******************
 
+..
+   Keep in sync with docs/index.rst.
+
 .. toctree::
-   :maxdepth: 2
+   :maxdepth: 1
    :caption: Contents:
 
    libraries
diff --git a/docs/index.rst b/docs/index.rst
@@ -5,18 +5,33 @@ Static Typing with Python
 Guides
 ======
 
+..
+   Keep in sync with docs/guides/index.rst.
+
 .. toctree::
-   :maxdepth: 2
+   :maxdepth: 1
 
-   guides/index
+   guides/libraries
+   guides/writing_stubs
+   guides/modernizing
+   guides/unreachable
+   guides/type_narrowing
+   guides/typing_anti_pitch
 
 Reference
 =========
 
+..
+   Keep in sync with docs/reference/index.rst.
+
 .. toctree::
-   :maxdepth: 2
+   :maxdepth: 1
 
-   reference/index
+   reference/generics
+   reference/protocols
+   reference/best_practices
+   reference/quality
+   typing Module Documentation <https://docs.python.org/3/library/typing.html>
 
 .. seealso::
 
@@ -27,7 +42,7 @@ Specification
 =============
 
 .. toctree::
-   :maxdepth: 2
+   :maxdepth: 1
 
    spec/index
 
diff --git a/docs/reference/index.rst b/docs/reference/index.rst
@@ -1,7 +1,12 @@
+:orphan:
+
 *********************
 Type System Reference
 *********************
 
+..
+   Keep in sync with docs/index.rst.
+
 .. toctree::
    :maxdepth: 2
    :caption: Contents:
