Architecture as Code: Why Your Diagrams Should Live in Git

Developer writing YAML architecture as code in terminal

TL;DR — Architecture as code means your service topology is defined in a structured file (YAML, JSON, or similar) that lives in your repository, is version-controlled, and generates your visualizations automatically. It’s the same principle as infrastructure as code applied to documentation: the source of truth is a file, not a diagram drawn by hand. […]