Architecture diagrams are like text documents. It's easy to create one, but hard to create a good one, writes Mark Johnson. How you craft these diagrams will have a tremendous impact on the correctness of the assumptions. Most common use case is diagrams used to transfer knowledge between humans, he says. Ultimately, it's only about transferring information to someone else in a compact way, he writes. The compact aspect is important, if the reader needs a lot of text to understand the diagram, Johnson says.
Read more at sportebois.medium.com