Milestone 5.11 — Public documentation platform (docs.ehxlabs.xyz)
Status: Platform shipped (Docusaurus); content pass — milestone-5-11-docs-content.md
Tracking: ehx-kb#39 (epic)
Goal
Operators, integrators, and customers need a stable documentation URL on docs.ehxlabs.xyz with real doc-site UX (nav, search)—not redirects to GitHub.
Canonical source: ehxlabs/ehx-kb/docs/ in Git. Published site: Docusaurus static build at docs.ehxlabs.xyz.
Platform (shipped)
| Piece | Issue |
|---|---|
Docusaurus + website/ | #45 |
| Caddy static host | ehx-web#64 |
| Footer link | ehx-web#60 |
| Build/deploy runbook | docs-site-docusaurus.md |
Engine: Docusaurus only (self-hosted). GitBook removed from scope.
Content (next)
User-facing guides and IA — see milestone-5-11-docs-content.md (#47–#53).
Current sidebar is milestone/runbook-heavy; adequate for operators, not yet proper end-user documentation.
Child tasks (platform)
| ID | Repo | Issue | Deliverable |
|---|---|---|---|
| M5.11.1 | ehx-kb | #39 | Epic |
| M5.11.2 | ehx-kb | #40 | README + index |
| M5.11.3 | ehx-web | #59 | Subdomain + TLS |
| M5.11.4 | ehx-web | #60 | Footer |
| M5.11.6 | ehx-kb | #45 | Docusaurus |
| M5.11.7 | ehx-web | #64 | Caddy static |
DNS / TLS
- A/AAAA for
docs.ehxlabs.xyz→ same host asehxlabs.xyz. - Caddy:
ehx-web/Caddyfile→/srv/docusaurus←ehx-kb/website/build.