← All Semantic Contracts

Docs-as-Code

How we write and build documentation

A semantic contract: vocabulary your project supplies itself — ready to drop into your CLAUDE.md / AGENTS.md.

    Documentation follows Docs-as-Code according to Ralf D. Müller:

  • AsciiDoc as format, PlantUML for inline diagrams, built by docToolchain
  • Version-controlled, peer-reviewed, and built automatically
  • Plain English according to Strunk & White (or Gutes Deutsch nach Wolf Schneider)
  • Projects following this contract include the `dtcw` wrapper and `docToolchainConfig.groovy` so PlantUML / AsciiDoc actually render.

Related Anchors