Documentation auto-generation: ADR и specs в живой сайт
## Что это
Документация ROX.ONE сегодня живёт в `docs/` репо. Vision: автоматическая публикация всех ADR / specs / superpowers как живой сайт (через Fumadocs / DocuSaurus), который обновляется на каждый merge в main.
Что входит:
- Live docs site: docs.rox.one
- ADR index с tags и cross-links
- Spec viewer: render Mermaid / sequence diagrams
- Per-feature changelog (auto-from CHANGELOG.md)
- API reference (auto from JSDoc + GraphQL schema)
- Multi-version: docs для v1.0, v1.1, edge
- I18n: русский / английский (заметки в RU + автоперевод в EN через DeepL)
- Search (Algolia DocSearch или typesense)
- Edit-on-GitHub button на каждой странице
## Зачем
Документация = onboarding + retention. Без живого сайта новички теряются. Со сайтом — самостоятельно учатся за пару часов, освобождают команду от support tickets.
## Источники вдохновения
- [fuma-nama/fumadocs](https://github.com/fuma-nama/fumadocs)
- [ghostty-org/website](https://github.com/ghostty-org/website)
- [duckdb/duckdb-web](https://github.com/duckdb/duckdb-web)
## 🔗 Linear
- [PZD-371](https://linear.app/kuhjie/issue/PZD-371) — backing ticket