Three additions to the docs site, all atomic to docs/:
1. Deployment configs (Dockerfile + Caddyfile + docker-compose.yml +
.env.example + Makefile) mirroring bingham/cucx's pattern. The
compose service uses caddy-docker-proxy labels with the operator's
.mcp.l.supported.systems wildcard DNS pattern; suggested subdomain
is mcaxl-docs.mcp.l.supported.systems.
2. Logo + favicon (forest-green palette matching the existing custom.css
accent). Wordmark uses ui-monospace with currentColor so Starlight
inverts on light/dark; icon-mark is a terminal chevron + three
diminishing query-row lines (audit-by-query motif).
3. Live cluster examples in reference/tools.md for axl_version,
axl_list_tables (route% pattern), and axl_describe_table
(routepartition). Outputs sanitized per python.md PII rules
(15.0.1.12900(234) → 15.0(1); cluster-fingerprinting build string
removed).
Build clean: 17 pages built, pagefind search index across all,
favicon resolves to /favicon.svg, logo fingerprinted into _astro/.
Not yet deployed — operator wires docker compose up when ready.
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.
