docs(tooling): rewrite docs-autogen README for Docusaurus; misc fixes

**tooling/docs-autogen/README.md** — full rewrite:
- Remove all Mintlify-specific content (docs.json, SidebarFix, apidocs-orphans,
  Mintlify dev server, api-reference.mdx, Known Issues section)
- Update pipeline overview: api/index.md landing page, normalize_rst_backticks
  pass in step 2, step 3 (nav rebuild) noted as auto-skipped in Docusaurus mode
- Correct apidocs-quality description (includes methods by default, not excluded)
- Add links to docs/PUBLISHING.md and docs/CONTRIBUTING_DOCS.md at the top
- Update file structure and troubleshooting table

**docs/PUBLISHING.md** — remove stale `uv run poe apidocs-orphans` reference
(task was deleted when --orphans was removed from audit_coverage.py)

**.github/workflows/docs-publish.yml** — add comment to release: trigger
explaining it only fires for manually-created releases (automated releases
use GITHUB_TOKEN which cannot trigger new workflow runs)

Assisted-by: Claude Code

Author: planetf1

.github/workflows/docs-publish.yml

@@ -14,6 +14,9 @@ on:
       - "tooling/docs-autogen/**"
       - ".github/workflows/docs-publish.yml"
 
+  # Fires for manually-created GitHub Releases only. Automated releases use
+  # GITHUB_TOKEN, which cannot trigger new workflow runs — those are handled
+  # by an explicit workflow_dispatch from the snapshot-docs job instead.
   release:
     types: [published]
 

docs/PUBLISHING.md

@@ -144,9 +144,6 @@ uv run python tooling/docs-autogen/audit_coverage.py \
 # Audit docstring quality only (via poe alias)
 uv run poe apidocs-quality
 
-# Find orphan MDX files not in navigation
-uv run poe apidocs-orphans
-
 # Full Docusaurus build (catches broken links)
 cd docs && npm run build
 ```