docs: move python and cli reference to separate pages

This helps tidy up the home page (only lists of commands, no table) and navigation bar (proper sections for High-level API commands and Command line reference).
datalad · Oct 9, 2023 · e3607da · e3607da
1 parent 81dcfe5
commit e3607da
Show file tree

Hide file tree

Showing 3 changed files with 20 additions and 7 deletions.
diff --git a/docs/source/cli_reference.rst b/docs/source/cli_reference.rst
@@ -0,0 +1,7 @@
+Command line reference
+======================
+
+.. toctree::
+   :maxdepth: 1
+
+   generated/man/datalad-hello-cmd
diff --git a/docs/source/index.rst b/docs/source/index.rst
@@ -11,21 +11,19 @@ API
 High-level API commands
 -----------------------
 
-.. currentmodule:: datalad.api
-.. autosummary::
-   :toctree: generated
+.. toctree::
+   :maxdepth: 2
 
-   hello_cmd
+   python_reference.rst
 
 
 Command line reference
 ----------------------
 
 .. toctree::
-   :maxdepth: 1
-
-   generated/man/datalad-hello-cmd
+   :maxdepth: 2
 
+   cli_reference.rst
 
 Indices and tables
 ==================

diff --git a/docs/source/python_reference.rst b/docs/source/python_reference.rst
@@ -0,0 +1,8 @@
+High-level API commands
+=======================
+
+.. currentmodule:: datalad.api
+.. autosummary::
+   :toctree: generated
+
+   hello_cmd