7 Common Mistakes in Architecture Diagrams

7 common architecture diagram mistakes:

  1. Theoretical rather than concrete diagrams.
  2. Mixing abstraction levels.
  3. Overlapping concerns causing busyness.
  4. Unlabeled arrows.
  5. Misleading composition of resources.
  6. Missing context for resources.
  7. Lack of explanatory text accompanying diagrams.

https://www.ilograph.com/blog/posts/diagram-mistakes/