Architecture diagrams enable better conversations
I've been using <a href="https://structurizr.com/" rel="nofollow noreferrer">https://structurizr.com/</a> to automatically generate C4 diagrams from a model (rather than drawing them by hand). It works well with the approach for written documentation as proposed in <a href="https://arc42.org/" rel="nofollow noreferrer">https://arc42.org/</a>. It's very easy to embed a C4 diagram into a markdown document.<p>The result is a set of documents and diagrams under version control that can be rendered using the structurizr documentation server (for interactive diagrams and indexed search).<p>I also use <a href="https://d2lang.com/" rel="nofollow noreferrer">https://d2lang.com/</a> for declarative diagrams in addition to C4, e.g., sequence diagrams and <a href="https://adr.github.io/" rel="nofollow noreferrer">https://adr.github.io/</a> for architectural decision records. These are also well integrated into structurizr.