Question

你可能会考虑包含在软件指南中的最后一件事是在软件系统开发过程中做出决策的日志。

意图

这个部分的目的是简单记录所做的重要决策，包括技术选择（比如，产品、框架等）和整体架构（比如，软件的结构、架构风格、分解、模式等）。

你为什么选择技术或框架X，而不是Y和Z？

你是怎么做的？产品评估还是概念证明？

你是否根据公司政策或企业架构战略而被迫做出关于X的决策？

你为什么选择所采用的软件架构？你考虑过其他哪些选项？

你怎么知道解决方案满足主要的非功能性需求？

等等。

结构

再说一次，用一小段文字描述你要记录的每个决策，保持简单。如果有其他资源，比如概念证明、性能测试结果或产品评价，一定要参考。

动机

记录重要决策的动机是这个部分在将来可以作为一个参考点。所有的决策都是依据特定的语境做出的，通常都有取舍。对一个给定的问题 ，通常没有完美的解决方案。事后阐明决策过程往往是复杂的，尤其是如果你向刚加入团队的人解释这个决策，或者处在一个定期变化语境的环境中。

尽管“从未有人因为购买IBM而遭解雇”，也许写下公司政策强迫你使用IBM WebSphere而不是Apache Tomcat的事实，会在将来为你省去一些令人头大的对话。

受众

主要是软件开发团队中的技术人员以及其他可以协助部署、支持和运营软件系统的人。

是否必须

不是，但如果我们（团队）在考虑技术选择或架构风格之类的重要事情上花费超过几分钟，我通常都会包含这个部分。如果有疑问，花几分钟写下来，特别是当你为一个在外包协议下给客户构建软件系统的咨询组织工作时。