configuring header and section navigation

Author: cassiasamp

docs/source/extending_and_contributing.rst

@@ -0,0 +1,10 @@
+Extending and Contributing
+==========================
+
+.. toctree::
+   :maxdepth: 1
+
+   extending
+   extending.generator
+   extending.probe
+   contributing

docs/source/index.rst

@@ -28,50 +28,9 @@ Check out the :doc:`usage` section for further information, including :doc:`inst
 
 
 .. toctree::
-   :caption: Using garak
    :maxdepth: 1
-   :hidden:
 
-   how
-   install
-   usage
-   configurable
-   cliref
-   reporting
-   translation
-   ascii_smuggling
-   FAQ <https://github.com/NVIDIA/garak/blob/main/FAQ.md>
+   using_garak
+   reference
+   extending_and_contributing
 
-.. toctree::
-   :caption: Reference
-   :maxdepth: 1
-   :hidden:
-
-   basic
-   attempt
-   buffs
-   cli
-   command
-   detectors
-   evaluators
-   exception
-   generators
-   harnesses
-   interactive
-   langservice
-   payloads
-   probes
-   report
-   _config
-   _plugins
-
-
-.. toctree::
-   :caption: Extending and Contributing
-   :maxdepth: 1
-   :hidden:
-
-   extending
-   extending.generator
-   extending.probe
-   contributing

docs/source/reference.rst

@@ -0,0 +1,23 @@
+Reference 
+=========
+
+.. toctree::
+   :maxdepth: 1
+
+   basic
+   attempt
+   buffs
+   cli
+   command
+   detectors
+   evaluators
+   exception
+   generators
+   harnesses
+   interactive
+   langservice
+   payloads
+   probes
+   report
+   _config
+   _plugins

docs/source/using_garak.rst

@@ -0,0 +1,15 @@
+Using ``garak`` 
+================
+
+.. toctree:: 
+   :maxdepth: 1
+   
+   how
+   install
+   usage
+   configurable
+   cliref
+   reporting
+   translation
+   ascii_smuggling
+   FAQ <https://github.com/NVIDIA/garak/blob/main/FAQ.md>