Matt Lane · Notes← All notes
2026-11-21 · Products & systems

Good Diagramming Practice

Show how the parts work together, not how every part works internally.

Treat the system as a graph of parts and relationships. Group related parts, preserve the connections between them, and abstract their internal details unless those details are necessary to understand the system.

The level of detail depends on what you're trying to explain. Something important at one level may be irrelevant at another.

The goal is to reveal the structure and behavior of the whole without exposing unnecessary details of its parts.

But deciding what belongs in a system and deciding what belongs in its diagram are different judgments.

Every part should justify its existence. Every detail should justify its visibility.