Design It!

Tell the Whole Story

In ​Build Models into the Code​ you learned that there will always be a gap between the models in the architecture and the code we write. We can close the model-code gap somewhat, but we can’t express every architectural design decisions in code. Nevermind that few stakeholders can read code and no code exists at the beginning of a system’s life when design planning is most needed.

We need architecture descriptions for several important reasons.

Get organized.

Building software is as much about working with people as it is working with technology. Architecture descriptions show how everything comes together. Whether we are assigning responsibilities to teams or letting people self-organize, everyone needs to know how components ...