docs(api) Visual improvements via gp-sphinx (#53)

Adopt the gp-sphinx Sphinx package stack for g's API
documentation. The net visual effect is card-style autodoc
signatures with safety and scope badges, MyST cross-reference
roles for Python objects, scoped section names in multi-page CLI
docs, and polished IBM Plex typography — all landing together from
the gp-sphinx 0.0.1a7 pre-release.

- **API-style autodoc layout** via sphinx-autodoc-api-style —
  card layouts, badges, MyST roles for Python objects
- **Shared badge layer** via sphinx-autodoc-badges — consistent
  XS/SM/LG/XL size variants with WCAG-AA contrast
- **Multi-page argparse scoping** via sphinx-argparse-neo — CLI
  doc builds no longer emit duplicate-label warnings
  (git-pull/gp-sphinx#16)
- **Font polish** via sphinx-fonts — IBM Plex Sans and Mono at
  full weight range, zero-CLS loading

See gp-sphinx 0.0.1a7 release notes for the full list of changes
covering 0.0.1a1..0.0.1a7:
https://github.com/git-pull/gp-sphinx/blob/v0.0.1a7/CHANGES

Author: tony

CHANGES

@@ -33,6 +33,11 @@ $ uvx --from 'g' --prerelease allow g
 _Notes on upcoming releases will be added here_
 <!-- END PLACEHOLDER - ADD NEW CHANGELOG ENTRIES BELOW THIS LINE -->
 
+### Documentation
+
+- Visual improvements to API docs from [gp-sphinx](https://gp-sphinx.git-pull.com)-based Sphinx packages (#53)
+
+
 ### CLI
 
 - `g --version` and `g -V` now display g's version instead of being passed to

docs/conf.py

@@ -30,7 +30,11 @@
     source_branch="master",
     light_logo="img/g.svg",
     dark_logo="img/g-dark.svg",
-    extra_extensions=["sphinx.ext.todo", "sphinx_argparse_neo.exemplar"],
+    extra_extensions=[
+        "sphinx_autodoc_api_style",
+        "sphinx.ext.todo",
+        "sphinx_argparse_neo.exemplar",
+    ],
     intersphinx_mapping={
         "py": ("https://docs.python.org/", None),
         "libvcs": ("http://libvcs.git-pull.com/", None),

pyproject.toml

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