Architecture diagrams enable better conversations
I&#x27;ve been using <a href="https:&#x2F;&#x2F;structurizr.com&#x2F;" rel="nofollow noreferrer">https:&#x2F;&#x2F;structurizr.com&#x2F;</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:&#x2F;&#x2F;arc42.org&#x2F;" rel="nofollow noreferrer">https:&#x2F;&#x2F;arc42.org&#x2F;</a>. It&#x27;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:&#x2F;&#x2F;d2lang.com&#x2F;" rel="nofollow noreferrer">https:&#x2F;&#x2F;d2lang.com&#x2F;</a> for declarative diagrams in addition to C4, e.g., sequence diagrams and <a href="https:&#x2F;&#x2F;adr.github.io&#x2F;" rel="nofollow noreferrer">https:&#x2F;&#x2F;adr.github.io&#x2F;</a> for architectural decision records. These are also well integrated into structurizr.