work in progress more depth

Author: Pierre-Sassoulas

doc/additional_tools/pyreverse/configuration.rst

@@ -2,8 +2,8 @@
 .. docs extension in 'doc/exts/pyreverse_configuration.py'.
 
 
-Basic usage
-###########
+Usage
+#####
 
 
 To run ``pyreverse``, use::
@@ -22,7 +22,7 @@ For detailed descriptions of the command-line options read on. This page include
 
 
 Filtering and Scope
-###################
+'''''''''''''''''''
 
 .. _filtering-and-scope:
 
@@ -90,7 +90,7 @@ Filtering and Scope
 
 
 Display Options
-###############
+'''''''''''''''
 
 .. _display-options:
 
@@ -140,7 +140,7 @@ Display Options
 
 
 Output Control
-##############
+''''''''''''''
 
 .. _output-control:
 
@@ -162,7 +162,7 @@ Output Control
 
 
 Project Configuration
-#####################
+'''''''''''''''''''''
 
 .. _project-configuration:
 

doc/additional_tools/pyreverse/index.rst

@@ -12,7 +12,10 @@ can be used as well. In this case, ``pyreverse`` first generates a temporary ``.
 fed to Graphviz to generate the final image.
 
 .. toctree::
-  :maxdepth: 1
+   :caption: Pyreverse
+   :maxdepth: 3
+   :titlesonly:
+   :hidden:
 
-  configuration
-  output_examples
+   configuration
+   output_examples

doc/exts/pyreverse_configuration.py

@@ -35,7 +35,7 @@ def _write_config_page(run: Run) -> None:
 .. docs extension in 'doc/exts/pyreverse_configuration.py'.
 
 
-{get_rst_title("Basic usage", "#")}
+{get_rst_title("Usage", "#")}
 
 To run ``pyreverse``, use::
 
@@ -69,7 +69,7 @@ def _write_config_page(run: Run) -> None:
     for group_title in OPTIONS_GROUPS.values():
         ref_title = group_title.lower().replace(" ", "-")
         sections.append(
-            f"""{get_rst_title(group_title, "#")}
+            f"""{get_rst_title(group_title, "'")}
 .. _{ref_title}:
 
 

doc/index.rst

@@ -30,6 +30,7 @@
 
 .. toctree::
    :caption: Additional tools
+   :maxdepth: 2
    :titlesonly:
    :hidden: