Diagramming - How to

Notes on Diagramming

We aim for effective communication. The following questions and pointers assist to provoke reflection on ensuring the proposed outcomes from undertaking this work are met:

• A target audienceWhoaudience.
  Who is the diagram for? Executives, developers, or just other architects?
  
  

• A defined purposeShouldpurpose.
  Should this provide an overview or is it meant to show how components interact? (for example)
  
  

• A cohesive narrativeEvennarrative.
  Even technical diagrams and documents should tell a story. How do the components of the diagram interact to fulfil the overall system's purpose?
  
  

• A broad perspective

  perspective.
  The goal is to convey fundamental structure and behaviour, not every detail

• A consistent visualGroupvisual.
  Group related technologies together or use the same icons and colours to show similar elements.
  If one line represents data flow it is likely that every line should represent data flow, etc …