alt Hacker NewsIn my experience in software architecture, drawing a diagram often saves you >60 minutes of discussion and potentially multiple meetings. This works even with a badly drawn but truthful one.
Use an Ai agent + Mermaid.js for a quick scribble if you are in a remote meeting. Use white boards or pen + paper in a local meeting.
Diagrams are so much clearer then words, especially if the concept or logic in question is not trivial.
Replies
UK-Al05 • today at 9:08 AM
I have feedback in the past that people don't like diagrams upfront, because it presents a finished solution.
Yes, it helps to keep the bigger picture (pun intended) in focus and something tangible to criticise. Same for design docs. Otherwise, the conversation‘s spotlight just keeps moving around and might even follow whatever thread one of the more prolific speakers just came up with, which carries the danger of derailing the whole thing and adjourning without a decision.