Pictures v Diagrams

Pictures v Diagrams

A picture is worth a thousand words, words which come down to interpretation.

A diagram is not the same as a picture. A diagram also tries to explain how things work and minimise the scope for erroneous interpretation. They should be efficient and exist to communicate complex processes and structures quickly and effectively.

A diagram needs context and has rules (e.g. does a dashed line indicate a dependency or the flow of data? do red lines show key features or highlight problem areas?). And multiple views may be required to cover everything (e.g. the data model, conceptual model, component model, key interactions etc.).

And a diagram has a purpose underlying it, a raison d'être - why does it exist? what it is it trying to explain? to whom?

Stop drawing pictures and start drawing diagrams. Add context, description, explanation and provide multiple perspectives when necessary. A picture alone is not enough. Don't leave things down to interpretation.


For example, this is the cover diagram with the relevant explanation (my beloved Fairlight Secan 2.5 geometry size guide).


要查看或添加评论,请登录

Kevin Barclay的更多文章

  • Road Maintenance

    Road Maintenance

    I live and spend most of my time cycling in the south east of England. I ride on a combination of dedicated cycle…

  • Off to see Nessie

    Off to see Nessie

    This weekend I’m off to Inverness for a ride around Loch Ness and a chance to spot the monster. I enjoy these events…

    4 条评论
  • Design Reviews

    Design Reviews

    Though I try, I suspect I'm as guilty as anyone. People in glass houses etc.

  • The internet is down, all is well

    The internet is down, all is well

    A few weeks ago I switched from Zen internet (stable enough; a touch more expensive than the big boys; excellent…

    6 条评论
  • We can't go on like this...

    We can't go on like this...

    I'm sitting here in the sun - yes, it's sunny in south London - and for the past 30 minutes I've been trying to buy…

    6 条评论
  • Don't treat people like serverless functions

    Don't treat people like serverless functions

    When I were knee high to a grasshopper we didn't have all this new fangled cloud infrastructure and we certainly didn't…

    4 条评论
  • Docs

    Docs

    There, I said it. A four letter swear word.

    4 条评论
  • The Con of Agile (or why agile reductionism is hard…)

    The Con of Agile (or why agile reductionism is hard…)

    Agile is, to a large extent, a radical breakdown of function into small incremental features delivered in a prioritised…

    3 条评论

社区洞察

其他会员也浏览了