How to Create an Interactive Architecture Diagram From a YAML File
TL;DR — This tutorial walks through building an interactive architecture diagram from YAML service definitions: what the YAML schema looks like, how the visualization layer reads it, how to deploy the result as static files on Netlify or GitHub Pages, and how to keep it current. Total time: under two hours for a first deployment. […]
Architecture as Code: Why Your Diagrams Should Live in Git
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. […]
