# Azumi Positioning & Docs Rewrite

All items complete.

1. **P0: Rewrite README.md** — ✅ Subtitle: "Server-rendered HTML with client interactivity — all Rust, zero custom JavaScript". Origin story, trilemma table, pitch, quickstart, "when to use / when not to".
2. **P0: Create docs/why-azumi.md** — ✅ Full narrative: origin, two problems, thesis, competitive landscape, when to use / when NOT to, "Azumi is complete", "no custom JS" proof.
3. **P1: Restructure docs/guide.md** — ✅ Inlined interactivity pattern catalog (tabs, accordion, confirm, reveal). Updated TrustedHtml as public.
4. **P1: Kill doc sprawl** — ✅ 12 docs → 3 (README, why-azumi, guide) + archive/ + migration/ + perf/.
5. **P1: "Stability as a feature" + "No custom JS" messaging** — ✅ In README + why-azumi.
6. **P1: Honest scope section** — ✅ In README + why-azumi.
7. **P2: Update crate-level doc** — ✅ In src/lib.rs.

Checklist:
- [x] 1. Rewrite README.md with subtitle, pitch, origin story, demo
- [x] 2. Create docs/why-azumi.md
- [x] 3. Restructure docs/guide.md
- [x] 4. Consolidate 12 docs → 3 (+ archive)
- [x] 5. Add "stability" and "no custom JS" messaging
- [x] 6. Honest scope section (when NOT to use)
- [x] 7. Update crate-level doc in src/lib.rs
