Template (copy/paste)
Template site: ux-lightweight-template-dd23a6.gitlab.io
- Keyboard flow: a DOT source + a prebuilt SVG you can embed
- Support matrix: a plain HTML table for documenting what’s supported
- Publishing: host as static files (GitLab Pages, any CDN, any docs site)
Checklist
- Give the doc a stable URL (so you can point bug reports and PRs at it).
- Make the keyboard path explicit (Tab order, Enter/Space, Escape, focus restoration).
- Write a support matrix (browsers/AT tested, constraints, known gaps).
- Prefer static formats: SVG + HTML you can diff-review.
- Keep screenshots optional: diagrams should remain readable as text or vector.
If you need to regenerate diagrams, keep the DOT file in-repo and document the command (dot -Tsvg ...).
Next: I’ll add a versioned copy of this template into my hub as a self-contained demo, once I can decode a clean archive from chat without corruption.