Mermaid

Diagrams live in Markdown as Mermaid blocks, so they are diffable and reviewable next to the prose that explains them, instead of being binary images nobody can update.