"... make the diagram concise and understandable; the sort of decisions that machines just aren't that good at. ..." Exactly. I've found that there is no perfe

"... make the diagram concise and understandable; the sort of decisions that machines just aren't that good at. ..." Exactly. I've found that there is no perfect tool and I'm closing in on 40 years of writing software. I use a blend of UML, IE (James Martin's Information Engineering), etc. Anything that makes it "easy-to-grok". Draw.io generally does what I want it to do; there is no feedback loop back to the codebase. It's really just to help onboard new helping hands.