What if your context maps, event flows, and dependency graphs just... generated themselves from Markdown?
What if your context maps, event flows, and dependency graphs just... generated themselves from Markdown? Your architecture diagrams are lying to you. Not intentionally — they were accurate the day...

Source: DEV Community
What if your context maps, event flows, and dependency graphs just... generated themselves from Markdown? Your architecture diagrams are lying to you. Not intentionally — they were accurate the day someone drew them. But that was six months ago, and since then three services got renamed, two teams reorganised, and the person who maintained the draw.io file left the company. The model still lives in a desktop app that nobody opens, on a Confluence page nobody finds, in someone's head that is now at a different employer. The tooling is either too heavy (paid enterprise tools that require a two-day training course) or too manual (Markdown ADRs that are great for decisions but tell you nothing about how 40 systems relate to each other). There is a gap between "I have docs" and "I have a living architecture model." The idea What if architecture elements were just Markdown files in Git? And what if the relationships you declared in those files were enough for the diagrams to draw themselves?