Improve sidebar presentation in specifications section

jeanas · jeanas · commit 4bbc74ccc26f · 2023-11-14T21:30:03.000+01:00
diff --git a/source/specifications/index.rst b/source/specifications/index.rst
@@ -8,50 +8,9 @@ by the Python Packaging Authority. The process for updating these standards,
 and for proposing new ones, is documented on
 `pypa.io <https://www.pypa.io/en/latest/specifications/>`__.
 
-
-Package Distribution Metadata
------------------------------
-
-.. toctree::
-   :maxdepth: 1
-
-   name-normalization
-   core-metadata
-   version-specifiers
-   dependency-specifiers
-   declaring-build-dependencies
-   declaring-project-metadata
-   inline-script-metadata
-   platform-compatibility-tags
-
-Package Installation Environment Metadata
------------------------------------------
-
-.. toctree::
-   :maxdepth: 1
-
-   recording-installed-packages
-   entry-points
-   direct-url
-   direct-url-data-structure
-   virtual-environments
-   externally-managed-environments
-
-Package Distribution File Formats
----------------------------------
-
-.. toctree::
-   :maxdepth: 1
-
-   source-distribution-format
-   binary-distribution-format
-
-
-Package Index Interfaces
-------------------------
-
 .. toctree::
-   :maxdepth: 1
 
-   pypirc
-   simple-repository-api
+   section-distribution-metadata
+   section-installation-metadata
+   section-distribution-formats
+   section-package-indices
diff --git a/source/specifications/section-distribution-formats.rst b/source/specifications/section-distribution-formats.rst
@@ -0,0 +1,8 @@
+=================================
+Package Distribution File Formats
+=================================
+
+.. toctree::
+
+   source-distribution-format
+   binary-distribution-format
diff --git a/source/specifications/section-distribution-metadata.rst b/source/specifications/section-distribution-metadata.rst
@@ -0,0 +1,14 @@
+=============================
+Package Distribution Metadata
+=============================
+
+.. toctree::
+
+   name-normalization
+   core-metadata
+   version-specifiers
+   dependency-specifiers
+   declaring-build-dependencies
+   declaring-project-metadata
+   inline-script-metadata
+   platform-compatibility-tags
diff --git a/source/specifications/section-installation-metadata.rst b/source/specifications/section-installation-metadata.rst
@@ -0,0 +1,13 @@
+=============================
+Package Installation Metadata
+=============================
+
+.. toctree::
+   :titlesonly:
+
+   recording-installed-packages
+   entry-points
+   direct-url
+   direct-url-data-structure
+   virtual-environments
+   externally-managed-environments
diff --git a/source/specifications/section-package-indices.rst b/source/specifications/section-package-indices.rst
@@ -0,0 +1,8 @@
+========================
+Package Index Interfaces
+========================
+
+.. toctree::
+
+   pypirc
+   simple-repository-api
