Week 2 – Communication and the Use of Language

Sat, 17 May 2025 00:00:00 +0000

Opening the thread for Chapter 2 – Communication and the Use of Language.

This chapter moves us closer to the interface between language, code, and clarity. Evans argues that the model should not be something floating outside the implementation, rather the best code should reveal the model directly. The diagrams and documents we write should support that, not compete with it.

A few lines that stood out:

“The vital detail about the design is captured in the code. A well-written implementation should transparently reveal the model underlying it. Supplemental diagrams and documents can guide people’s attention to the central points. Natural language discussion can fill in the nuances of meaning.”

Communication on communities.abhinav-ja.in

Week 2 – Communication and the Use of Language