- Communication is a key architecture skill
- Consider the context of who you are communicating too and how it would be best received or understood
- Simple not simplistic
- You must consider future teams and architects, years from now decisions will be questioned and problems revisited. Shortcut that future pain by making sure the past can be understood.
Architecture Decision Records (ADRs)
- A framework for recording choices that are architecturally significant
- Helps with knowledge transfer over the lifetime of a product
- The process of filling in ADRs helps solidify thinking on a decision