Design Decisions
Why Antora?
| Alternative | Problem | Why Antora Wins |
|---|---|---|
GitHub Wiki |
No CI/CD, no cross-repo |
Full Git workflow, multi-repo native |
GitBook |
SaaS lock-in, limited customization |
Self-hosted, fully customizable |
MkDocs |
Single repo focus |
Multi-repo aggregation built-in |
Docusaurus |
JavaScript-heavy, React dependency |
Static HTML, minimal JS |