Commit a16cb10
committed
Resolves FR-2711
## Summary
- Add feature spec for production-level improvements to the webui-docs static site (Option A — incremental in-house toolkit improvements, no SSG migration)
- 6 feature buckets / 6 sub-tasks under epic FR-2710:
- **F1** — Site entry & multilingual routing
- **F2** — SEO & sharing metadata
- **F3** — Information architecture (sidebar grouping + right-rail TOC + breadcrumbs)
- **F4** — Reading UX: code blocks (Shiki syntax highlighting + Copy button — dark mode deferred to a separate follow-up)
- **F5** — Build robustness & static asset optimization
- **F6** — Versioned docs & version selector (minor-grained; eligibility limited to minors that build cleanly on the current toolkit; past-minor artifacts stored on GitHub orphan branches `docs-archive/<version>`)
- Cross-cutting acceptance: every bucket's PR must verify **PDF pipeline (`build:pdf`) does not regress** — both pipelines share `markdown-processor.ts` and `book.config.yaml`
- Hosting / AWS Amplify deployment pipeline (how the orphan-branch archives get merged and exposed publicly) is **deferred to a separate deployment spec** to keep this spec focused on the toolkit
- Epic: FR-2710
## Test plan
- [ ] Spec file renders correctly on GitHub
- [ ] Each bucket has clear, testable acceptance criteria
- [ ] Cross-cutting PDF non-regression criteria are explicit and actionable
- [ ] No overlap with FR-2159 / FR-2160 (both Done)
1 parent d924738 commit a16cb10
2 files changed
Lines changed: 270 additions & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
| 1 | + | |
| 2 | + | |
| 3 | + | |
| 4 | + | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
| 9 | + | |
| 10 | + | |
| 11 | + | |
0 commit comments