TechradarDev/radar/2021-07-01/diagrams-as-code.md

title, ring, quadrant, tags

title	ring	quadrant	tags
Diagrams as Code	adopt	methods-and-patterns	architecture quality assurance documentation

Documenting concepts and software architecture as diagrams using code offers great benefit over heavier solutions. Having documentation and diagrams treated as code and checked-in into version control increases transparency, collaboration as well as productivity. The textual representation of diagrams is easy to write and read. Generation of graphical representations as SVG or PNG images is also easy with the associated tools.

We make heavy use of PlantUML combined with Asciidoc and tools like AsciiDoctor Diagram to include and inline PlantUML diagrams into documentations. The latter allows a variety of other diagram formats which can be easily mixed and matched.