Great diagrams are not just beautiful pictures. Great diagrams are accurate models that reflect the conceptual underpinnings of the architecture. Architects may be infamous for drawing box and line diagrams, but there’s more going on in these diagrams than just coarse-grained abstractions.
As you learned in Show the Architecture from Different Views, you can show many different design ideas with diagrams. Visualizing the architecture with a diagram makes it tangible in a way that other mediums cannot. Fantastic diagrams make the architecture accessible to everyone.
Here are some tips for creating fantastic diagrams:
|Do this||Avoid this|
|Do: Create a legend that summarizes parts of the meta-model relevant to this diagram. ...|