An ADR captures the "why" behind a technical choice.
Modern diagramming is —it’s about creating a shared, maintainable, and executable model of your software’s architecture. creating software with modern diagramming techniques pdf
To understand modern techniques, we must first look at the legacy problem. Traditionally, software architecture was documented using Unified Modeling Language (UML) tools like Visio or Enterprise Architect. These tools relied on a graphical user interface (GUI). While powerful, they created a disconnect: An ADR captures the "why" behind a technical choice