AJR/TechradarDev
2
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Change release date to July of 2021

Browse Source
This commit is contained in:
dennis.ludwig
2021-07-12 10:19:10 +02:00
parent 6242b5c87e
commit 3be826c65a
65 changed files with 0 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
radar/2021-07-01/diagrams-as-code.md Normal file
View File

@@ -0,0 +1,12 @@
---
title: "Diagrams as Code"
ring: adopt
quadrant: methods-and-patterns
---
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](/tools/plant-uml.html) combined with [Asciidoc](/tools/asciidoc.html) and tools like [AsciiDoctor Diagram](https://asciidoctor.org/docs/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.