Diagramming with Mermaid

What if architectural diagrams could live in source control?