
AsciiDoc & Kroki: a proven combination for clear software documentation
Software documentation today is more than just a mandatory task. It is part of the development process and must be as agile, versionable and automatable as source code itself. Classic office documents or proprietary wikis quickly reach their limits. Changes are hard to trace, collaboration is cumbersome and integration into CI/CD pipelines is hardly possible. AsciiDoc and Kroki address exactly these points. Both tools embody the Docs-as-Code approach, where documentation is treated like source code. AsciiDoc provides an expressive text-based language for technical documentation that can be managed in Git and processed automatically. Kroki complements this with the ability to embed diagrams directly in the document and render them automatically. This allows developers to use diagrams without needing to install additional tools. ...








