知识卡片
文档记录取舍
内容
好的设计文档不仅记录采用的结构,也记录被放弃的备选方案及原因。后者保存了决策上下文,让后来维护者知道边界来自权衡,而不是偶然。
参考来源
- 位置:《UML精粹:标准对象建模语言简明指南》第2章《开发过程》(源文件:_epub-src/EPUB/1.xhtml)
- 结论依据:原文围绕“你没有采纳的设计备选方案以及没有采纳的原因”给出定义、对比或使用限制,说明该概念的含义和适用边界,因此可推出本卡片结论。
- 原始内容:文档中最重要的一项内容是你没有采纳的设计备选方案以及没有采纳的原因。这是你可以提供的外部文档中,经常最容易忘记、但最有用的部分。