Docs-as-Code

Wie wir Dokumentation schreiben und bauen

Ein Semantic Contract: Vokabular, das dein Projekt selbst mitliefert — zum Einsetzen in deine CLAUDE.md / AGENTS.md.

Dokumentation folgt Docs-as-Code nach Ralf D. Müller:

AsciiDoc als Format, PlantUML für Inline-Diagramme, gebaut von docToolchain
Versioniert, reviewt und automatisch gebaut
Gutes Deutsch nach Wolf Schneider (oder Plain English nach Strunk & White)
Projekte, die diesem Contract folgen, enthalten den `dtcw`-Wrapper und `docToolchainConfig.groovy`, damit PlantUML / AsciiDoc tatsächlich gerendert werden.

Verwandte Anker