1 Commits

Author SHA1 Message Date
f060170e90 docs: scaffold Starlight site at docs/
17-page Astro/Starlight site mirroring the bingham/cucx conventions
(telemetry off, devToolbar off, astro-icon + lucide, separate
custom.css, Diátaxis-structured sidebar with autogenerate per
directory). Green accent palette differentiates from bingham/cucx's
teal.

Pages by Diátaxis quadrant:
  - Getting Started (3): installation, configuration, first-audit
  - How-To (4): sip-trunk-report (port from docs/query-patterns/),
    route-plan-overview, investigate-pattern (mermaid flowchart),
    find-orphan-resources
  - Reference (4): tools (all 19), prompts (all 10), env-vars,
    cucm-schema-cheatsheet
  - Explanation (4): read-only-by-structure, cluster-isolated-cache,
    hamilton-review-patterns, pypi-yank-lesson

Build-verified clean (npm run build → 17 pages in 7.88s, pagefind
search index built across all pages, zero errors).

Legacy docs/query-patterns/sip-trunk-report.md kept in place — that
file ships in the published Python sdist's docs/ tree, deletion would
be a package change not just a docs-site change. The new how-to
version is a near-verbatim port.

Content gaps for follow-up: real cluster-output examples in tool/
prompt reference pages, verified CUCM 15 SQL in
find-orphan-resources.md, optional favicon.

Not yet wired for deployment (Caddyfile/Dockerfile out of scope for
v1). Local preview: cd docs && npm run dev.
2026-04-29 04:01:13 -06:00