Drawing good architecture diagrams National Cyber Security Centre

This resource first appeared in issue #36 on 07 Aug 2020 and has tags Technical Leadership: Other, Working With A Research Community: Communications Tools, Managing A Team: Documentation/Writing

Drawing good architecture diagrams - Toby W, (UK) National Cyber Security Centre

A nice overview of drawing architecture diagrams. The article makes the point that the diagram is about communicating, and if it doesn’t communicate the key points of the system to the readers, then it’s not succeeding. I like this advice:

Start with a basic high level concept diagram which provides a summary. Then create separate diagrams that use different lenses to zoom into the various parts of your system.

Having multiple diagrams of the same system viewed through different “lenses” seems more likely to be a success than trying to cram everything into one diagram.