2024
Infrastructure diagramming with Mermaid
A text-first approach to documenting infrastructure so architecture can move through pull requests instead of image files.
Infrastructure diagrams are only useful when people can change them. Mermaid is a good fit because it turns the diagram into text, which means it can live in the same review flow as code and deployment notes.
The value is not just the picture. It is the conversation created by making dependencies, data flow, and operational assumptions visible.