Re:Sketchviz – Graphviz graphs in a hand-drawn style
by Fellshard on Tuesday November 12, 2019 @08:50PM
(#21520434)
This. With the right tooling, you can embed diagrams as part of a larger document using a code block, which can be tuned and maintained as the system it's describing changes.
Once you learn the rules for the type of diagram you're making, it's much simpler than opening up <diagram tool of choice> and trying to shuffle the pieces around to make room for the change, or re-sketching the whole diagram from scratch on a piece of paper.
Maintainability. With declarative text-based diagramming, you can check these in as text files, and when the system evolves or the diagram has a need to change, it's easy to make a change and re-generate the image.