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

Please authenticate to join the conversation.

Upvoters
Status

In Review

Board
🧑‍🤝‍🧑

Compounding & Collaboration

Date

About 19 hours ago

Author

agi

Subscribe to post

Get notified by email when there are changes.