[dpark]

> I can't remember any occasions where the diagram actually cleared things up though.

I would be very concerned about the quality of the engineers I was working with if they couldn’t produce helpful diagrams.

It’s not coincidental that discussion of system architecture is usually accompanied by diagrams. They should be helpful. And in fact…

> Coming to think of it, one way that seems to be pretty effective at getting complex designs across is in an interactive presentation with the presenter drawing on a whiteboard, starting simple and adding stuff while explaining what and why.

You seem to agree that they are helpful.

> The whiteboard drawings by themselves are absolutely useless.

This seems like sort of a straw man, though. I don’t think anyone advocates for system diagrams in the absence of any context.

[vanviegen]

> This seems like sort of a straw man, though. I don’t think anyone advocates for system diagrams in the absence of any context.

My point is that I see value in interactively building up a diagram together. The final artifact, even when provided with context in the form of prose, I've never found to be actually helpful. Apart from good looks of course.