Improve API reference doc structure

Author: dstansby

.gitignore

@@ -51,7 +51,7 @@ coverage.xml
 
 # Sphinx documentation
 docs/_build/
-docs/_autoapi
+docs/api
 docs/data
 data
 data.zip

docs/Makefile

@@ -52,7 +52,7 @@ help:
 .PHONY: clean
 clean:
 	rm -rf $(BUILDDIR)/*
-	rm -rf $(BUILDDIR)/../_autoapi
+	rm -rf $(BUILDDIR)/../api
 
 .PHONY: html
 html:

docs/api/index.rst

@@ -57,7 +57,7 @@
 autoapi_add_toctree_entry = False
 autoapi_generate_api_docs = True
 autoapi_member_order = "groupwise"
-autoapi_root = "_autoapi"
+autoapi_root = "api"
 autoapi_keep_files = True
 autoapi_options = [ 'members', 'undoc-members', 'show-inheritance', 'show-module-summary', 'imported-members', ]
 
@@ -108,6 +108,7 @@ def skip_submodules(
      "release": "developers/release.html",
      "roadmap": "developers/roadmap.html",
      "installation": "user-guide/installation.html",
+     "api": "api/zarr/index"
 }
 
 # The language for content autogenerated by Sphinx. Refer to documentation

docs/conf.py

@@ -10,7 +10,7 @@ Zarr-Python
 
     quickstart
     user-guide/index
-    api/index
+    API reference <api/zarr/index>
     developers/index
     developers/release
     about
@@ -81,12 +81,12 @@ Zarr-Python is a Python library for reading and writing Zarr groups and arrays.
 
         +++
 
-        .. button-ref:: api/index
+        .. button-ref:: api/zarr/index
             :expand:
             :color: dark
             :click-parent:
 
-            To the API reference guide
+            To the API reference
 
     .. grid-item-card::
         :img-top: _static/index_contribute.svg