Diagramming

A diagram earns its place by answering one question faster than a paragraph could. A diagram showing everything answers nothing — it is the visual equivalent of a page with no headings.

Draw diagrams as code. A Mermaid block in the repository is diffable, reviewable, and edited by whoever changes the system. An exported PNG from someone's laptop is wrong within a month and nobody can fix it.