Skip to content

Use MkDocs and C4 Diagrams

  • Status: Accepted
  • Deciders: iakovn
  • Date: 2025-10-20

Context and Problem Statement

Need consistent high-level architecture documentation

Considered Options

  • Confluence
  • oneNote
  • Mkdocs

Decision Outcome

Chosen option: "Mkdocs", because :

  • Free
  • no vendor lock-in
  • standard markdown
  • easy to unify with other dev processes.