ADR-002: Docusaurus 3.x as the Publishing Foundation
- Status: Accepted
- Score: 88.6/100 (Weighted 11-criterion evaluation)
- Date: 2026-08-12
Context & Problem Statement
DOCCAD requires a modern static documentation framework supporting multi-instance documentation plugins (to segregate /docs from /views), React 19 component extensibility, offline static compilation, local search, and bilingual i18n (en and hu).
Decision
Adopt Docusaurus 3.x as the primary publishing framework.
- Configure
@docusaurus/plugin-content-docsfor canonical docs (/docs) and derived views (/views). - Integrate
@easyops-cn/docusaurus-search-localfor build-time offline search indexing. - Use
@docusaurus/theme-mermaidfor diagrams as code.
Revisit Trigger
If Docusaurus build times exceed 10 minutes on corpora over 5,000 pages, evaluate adopting @docusaurus/faster (Rspack compiler) or migrating to MkDocs+Material via our documented exit plan.