docs: RTD hygiene — delete dead configs, converge conf.py, add docs CI

[Jammy2211]

Summary

Closes the PyAutoFit leg of #1341 (phase A of the docs-infrastructure census). Deletes readthedocs.yml (dead py3.11 duplicate — RTD only reads .readthedocs.yaml) and docs/requirements.txt (dead — RTD installs the pyproject [docs] extra; the file pinned ancient deps like SQLAlchemy==1.3.20 while looking authoritative). Converges docs/conf.py on the Galaxy/Lens variant: enables sphinx_autodoc_typehints (shipped in the [docs] extra but never enabled), adopts the shared autodoc/numpydoc/typehints settings, removes the dead html_context block and the phantom _static CSS refs. Adds the docs CI check (thin caller into PyAutoHeart's docs-build.yml, merged in PyAutoHeart#48) gated on docs/sphinx_warning_baseline.txt (67).

Note this leg changes API-page rendering by design (separated class signatures, __init__-content classes, imported members documented — matching how Galaxy/Lens docs render). Verified locally: 29 autosummary pages generate, autofit.Model page renders complete with Parameters section.

This does not fix the dead RTD site by itself — pyautofit.readthedocs.io has not built since 2026-05-06 because the RTD project still points at rhayes777/PyAutoFit.git; the dashboard reconnection (human leg on #1341) is what revives it.

API Changes

None — docs/CI configuration only.

Test Plan

• PyAutoFit suite: 1424 passed, 14 skipped (full, worktree)
• Sphinx before/after: 63 → 67 warnings; delta fully explained (−1 phantom-_static, −1 docutils artifact, +6 typehints forward-reference warnings surfaced by the newly enabled extension — pre-existing TYPE_CHECKING-guarded annotation debt, now visible)
• docs check green on this PR (baseline 67; Galaxy/Lens baselines held exactly in CI, so no recalibration expected)

Validation checklist (--auto run)

• Effective level: supervised (header: supervised, cap: docs ≤ medium → safe)
• Plan: on the issue (docs: RTD hygiene — reconnect PyAutoFit RTD, converge conf.py, add docs CI #1341), written at start; this leg unlocked by the human's in-session claim override ("they don't clash") — disjointness verified against ep-diagnostics (9 files, non_linear/diagnostics area) and ep-graphical-docs PR#1334 (graphical/messages/AGENTS.md): zero file overlap with this diff
• Gate: tests 1424 pass / 14 skip · smoke n/a (docs+CI only) · review CLEAN · Heart YELLOW within in-session ack (reason set re-checked at this ship — identical to the acked list)
• Human: plan sound in hindsight?
• Human: diff matches plan (no scope creep)?
• Human: merge, amend, or reject — then log the outcome

Full API Changes (for automation & release notes)

None — files touched: readthedocs.yml (deleted), docs/requirements.txt (deleted), docs/conf.py, .gitignore, .github/workflows/docs.yml (new), docs/sphinx_warning_baseline.txt (new).

🤖 Generated with Claude Code

https://claude.ai/code/session_01GziFkivBHz1d11eFYUszmy