docs(gp-sphinx) Bump gp-sphinx to v0.0.1a8 (#54)

Adopt gp-sphinx v0.0.1a8: ArgparseDomain, gp-sphinx-* CSS
namespace, sphinx>=8.1 floor, typed env.domains.* accessors, and
package renames (sphinx-autodoc-layout → sphinx-ux-autodoc-layout,
sphinx-autodoc-badges → sphinx-ux-badges).

Also renames sphinx-argparse-neo==0.0.1a7 →
sphinx-autodoc-argparse==0.0.1a8 (extension path updated in
docs/conf.py).

Preserves two doc-fix commits carried forward from the previous
autodoc-improvements branch (grid-item-card ref-links; manual
"Usage" heading rename to avoid argparse id collision).

See also: https://pypi.org/project/gp-sphinx/0.0.1a8/

Author: tony

CHANGES

@@ -36,6 +36,7 @@ _Notes on upcoming releases will be added here_
 ### Documentation
 
 - Visual improvements to API docs from [gp-sphinx](https://gp-sphinx.git-pull.com)-based Sphinx packages (#53)
+- Bump gp-sphinx docs stack to v0.0.1a8 (#54)
 
 
 ### CLI

docs/cli/index.md

@@ -6,14 +6,14 @@
 :gutter: 2 2 3 3
 
 :::{grid-item-card} g
-:link: #command
-:link-type: url
+:link: cli-main
+:link-type: ref
 Proxy to your repo's VCS command.
 :::
 
 :::{grid-item-card} Supported VCS
-:link: #supported-vcs
-:link-type: url
+:link: cli-supported-vcs
+:link-type: ref
 git, svn, and hg detection.
 :::
 
@@ -31,7 +31,7 @@ When you run `g`, it:
 
 **Note:** `--version`/`-V` is handled by g itself rather than passed to the VCS.
 
-## Usage
+## Usage examples
 
 ```console
 $ g status
@@ -65,6 +65,8 @@ $ g log --oneline -10
 $ g diff HEAD~1
 ```
 
+(cli-supported-vcs)=
+
 ## Supported VCS
 
 | Directory marker | VCS command |

docs/conf.py

@@ -33,7 +33,7 @@
     extra_extensions=[
         "sphinx_autodoc_api_style",
         "sphinx.ext.todo",
-        "sphinx_argparse_neo.exemplar",
+        "sphinx_autodoc_argparse.exemplar",
     ],
     intersphinx_mapping={
         "py": ("https://docs.python.org/", None),

pyproject.toml

@@ -59,9 +59,9 @@ dev = [
   # Docs
   "aafigure",
   "pillow",
-  "gp-sphinx==0.0.1a7",
-  "sphinx-argparse-neo==0.0.1a7",
-  "sphinx-autodoc-api-style==0.0.1a7",
+  "gp-sphinx==0.0.1a8",
+  "sphinx-autodoc-argparse==0.0.1a8",
+  "sphinx-autodoc-api-style==0.0.1a8",
   "gp-libs",
   "sphinx-autobuild",
   # Testing
@@ -85,9 +85,9 @@ dev = [
 docs = [
   "aafigure",
   "pillow",
-  "gp-sphinx==0.0.1a7",
-  "sphinx-argparse-neo==0.0.1a7",
-  "sphinx-autodoc-api-style==0.0.1a7",
+  "gp-sphinx==0.0.1a8",
+  "sphinx-autodoc-argparse==0.0.1a8",
+  "sphinx-autodoc-api-style==0.0.1a8",
   "gp-libs",
   "sphinx-autobuild",
 ]