docs: Complete documentation site, add autodoc extensions, and MystLexer

[tony]

Summary

Large docs-and-feature branch covering three areas:

1. Documentation site build-out (62b6550 → 0e96e0b)

• Complete package reference pages for all 7 packages (gp-sphinx, sphinx-fonts, sphinx-gptheme, sphinx-argparse-neo, sphinx-autodoc-docutils, sphinx-autodoc-sphinx, sphinx-autodoc-pytest-fixtures)
• New docs/_ext/package_reference.py extension — introspects live setup() calls and renders directives, roles, and config-value tables automatically
• docs/configuration.md — full reference for all merge_sphinx_config() defaults
• docs/api.md — API reference with make_linkcode_resolve wiring example
• docs/quickstart.md — "Your first build" tutorial section
• Redirect map (docs/redirects.txt) for moved pages
• Live demos on package pages using sphinx-autodoc-docutils and sphinx-autodoc-sphinx

2. New packages: sphinx-autodoc-docutils and sphinx-autodoc-sphinx

• sphinx-autodoc-docutils — documents docutils directives and roles from Python callables as rst:directive/rst:role reference blocks
• sphinx-autodoc-sphinx — documents Sphinx config values registered by app.add_config_value() as live confval entries and summary index tables
• Both packages: full pyproject.toml, typed stubs (py.typed), NumPy docstrings, mypy-strict typing

3. MystLexer for {eval-rst} fenced block highlighting (968e4c3 → 37a3be0)

Root cause: MarkdownLexer's fenced-block language pattern [\w\-]+ rejects {eval-rst} (the {} don't match), so blocks fall through to plain Token.Text with no syntax spans.

• packages/gp-sphinx/src/gp_sphinx/myst_lexer.py — MystLexer(MarkdownLexer) with a priority rule for ```{eval-rst} blocks; delegates body to RstLexer(handlecodeblocks=True) for 3-level nesting (MyST → RST → inner language)
• stubs/pygments/lexers/markup.pyi — local stub for MarkdownLexer/RstLexer (not in types-Pygments)
• config.py registers "myst"/"myst-md" aliases via app.add_lexer()
• Doc pages changed from ````md to ````myst — md fell through to Pygments' MarkdownLexer while myst hits Sphinx's lexer_classes["myst"] (verified via live HTML inspection showing highlight-myst class and proper <span class="sb"> elements)

Fixes

• refactor(config): Add description= to all add_config_value() calls
• fix(sphinx-fonts): Shorten description strings for E501
• fix(docs): GitHub source links tree/master → tree/main
• fix(sphinx-autodoc-sphinx): option_spec type annotation and _Opt tuple unpacking

Test plan

• uv run pytest — 611 passed, 3 skipped
• uv run mypy — no issues
• uv run ruff check . — no issues
• Visual: {eval-rst} blocks on /packages/sphinx-autodoc-sphinx/ and /packages/sphinx-autodoc-docutils/ render with highlight-myst class and RST syntax spans

[tony]

Code review

Found 3 issues:

1. config.py docstrings for deep_merge, make_linkcode_resolve, and merge_sphinx_config use Sphinx :param:/:type:/:rtype: style instead of NumPy Parameters\n---------- / Returns\n------- style. (CLAUDE.md says "Follow NumPy docstring style for all functions and methods")

gp-sphinx/packages/gp-sphinx/src/gp_sphinx/config.py

Lines 82 to 90 in 9eaec87

	:param base: The base dictionary.
	:type base: dict
	:param override: The dictionary whose values take precedence.
	:type override: dict
	:returns: A new merged dictionary.
	:rtype: dict

2. packages/sphinx-autodoc-sphinx/src is absent from testpaths in pyproject.toml, so the 20 doctests in sphinx_autodoc_sphinx/_directives.py are never collected by the default test run. (CLAUDE.md says "Doctests MUST actually execute")

gp-sphinx/pyproject.toml

Lines 158 to 167 in 9eaec87

	]
	testpaths = [
	"tests",
	"docs",
	"packages/gp-sphinx/src",
	"packages/sphinx-fonts/src",
	"packages/sphinx-gptheme/src",
	]
	filterwarnings = [
	"ignore:distutils Version classes are deprecated. Use packaging.version instead.",

3. docs/conf.py passes source_branch="master" to merge_sphinx_config(), which populates html_theme_options["source_branch"]. Sphinx-gptheme uses this to build the "View source" and "Edit on GitHub" links on every docs page. The repo's default branch is main, so those links 404. The PR's own master→main sweep (64914ad, abe27e5) fixed prose URLs but missed this parameter.

gp-sphinx/docs/conf.py

Lines 34 to 38 in 9eaec87

	source_repository=f"{gp_sphinx.__github__}/",
	docs_url=gp_sphinx.__docs__,
	source_branch="master",
	extra_extensions=[
	"package_reference",

🤖 Generated with Claude Code

_{- If this code review was useful, please react with 👍. Otherwise, react with 👎.}