Ugrás a fő tartalomra

Six-Platform Research & Evaluation

During the initial architecture phase of DOCCAD, six leading documentation platforms were rigorously evaluated across 11 weighted criteria:

  1. Docusaurus 3.x (Meta Open Source)
  2. Mintlify (Commercial SaaS / Git sync)
  3. MkDocs + Material (Python Docs-as-Code)
  4. Zensical (Modern Static Docs)
  5. Hyperbook (Interactive Book Framework)
  6. GitBook (Hosted Docs SaaS)

Weighted Scorecard Summary​

RankPlatformTotal Score (/100)Primary StrengthsDisqualifying Limitations
1Docusaurus 3.x88.6Dual docs-plugin instances, React 19 component ecosystem, native offline build, local searchRequires Node.js toolchain
2Mintlify85.0Polished default typography, built-in componentsClosed SaaS hosting, lacks dual-plane separation
3MkDocs + Material83.8Lightweight Python toolchain, excellent search, fast buildsLimited dynamic React component extensibility
4Zensical76.4Clean Markdown supportImmature ecosystem, unproven multi-plane architecture
5Hyperbook76.0Clean layout, good for structured tutorialsRigid navigation taxonomy, limited search plugin support
6GitBook72.2User-friendly WYSIWYG editorProprietary sync conflicts, high cost, SaaS dependency

The Selection Rationale​

Docusaurus won primarily due to Architectural Sovereignty:

  • It can be built completely offline inside an isolated container with zero outbound internet access.
  • Its @docusaurus/plugin-content-docs supports multiple concurrent instances with separate route trees (/docs vs /views), providing physical enforcement of canonical vs derived content planes.
  • Native React MDX enables rich interactive components like <EvidenceLink> and <InterviewPrep> without runtime server requirements.