Use toctree instead normal list so correct index always appear in the left menu

Fixes #246 (closed)

doc/source/main_authoring.rst

@@ -8,39 +8,15 @@ This section details how to use the BuildStream YAML format to
 create your own project or modify existing projects.
 
 
-Project format
---------------
-* :ref:`formatintro`
-
-  * :ref:`format_structure`
-  * :ref:`format_composition`
-  * :ref:`format_directives`
-
-* :ref:`projectconf`
-
-  * :ref:`project_essentials`
-  * :ref:`project_shell`
-  * :ref:`project_plugins`
-  * :ref:`project_options`
-  * :ref:`project_defaults`
-  * :ref:`project_builtin_defaults`
-
-* :ref:`format`
-
-  * :ref:`format_basics`
-  * :ref:`format_dependencies`
-  * :ref:`format_variables`
-
-* :ref:`public`
-
-  * :ref:`public_integration`
-  * :ref:`public_split_rules`
-  * :ref:`public_overlap_whitelist`
-
-* :ref:`projectrefs`
-
-  * :ref:`projectrefs_basics`
-  * :ref:`projectrefs_format`
+.. toctree::
+   :maxdepth: 2
+   :caption: Project format
+
+   formatintro
+   projectconf
+   format
+   public
+   projectrefs
 
 
 Plugins