知识卡片
决策需要证据
内容
架构不只是最终结构,还包括结构背后的决策和证据。记录备选方案、选择理由、约束来源和影响范围,能让维护者理解为什么不能轻易改,也能让后续评审避免重复推导。发散:ADR 的价值不在“写文档”,而在保留团队当时的判断上下文。
参考来源
- 位置:《架构实战:软件架构设计的过程》第2章《架构、架构师和架构设计》2.1.5节“架构基于合理证据使决策具体化”(源文件:_chapter-text/ch02.txt)
- 结论依据:原文明确指出架构的重要方面不仅是最终结果,还要有解释为什么这样做的合理证据,这些信息对维护系统的人和架构师本人回顾决策依据都很有价值,直接支持“决策需要证据”。
- 原始内容:架构的一个重要方面不仅是最终结果——架构本身,还要有解释为什么这样做的合理证据……这些信息与许多利益相关者有关,尤其与那些必须维护系统的人有关。当架构师需要回顾他们所做决策背后的根本原因时,这些信息对他们自己也很有价值,他们可以不必重新回顾以前的步骤。