Jacqui Reed at DDD Europe 2025
summary
Diagrams with boxes and colors often fail because lines lack meaning and arrows are missing, so people cannot recall or explain them. The concrete remedy is to label every line and connector, add arrowheads and a legend for colors, keep text legible and include a short intent note for each diagram. When diagrams carry explicit labels and a one-line purpose people can reproduce the story and use the diagram instead of guessing.
AI-written summary · about
related talks
15mDraw me a software or the art of diagrams that stick in the mind
41mDesign Patterns for Software Diagramming
45mA Picture is Worth 1000 Lines of Code
49mFrom Doodles to Dashboards, Data Flows, and Docs
18mCrayon Drawing Is a Vital Engineering Skill
21mDoodle-Driven Development
38mA Picture Is Worth a 1000 Lines of Code
27mThe Lost Art of Diagrams: Making Complex Ideas Easy to See with Python