提示9-9:遵循_建议以获得良好的ADR_
#decision #adr
建筑决策记录的支持者之一乔尔·帕克·亨德森收集了关于良好建筑决策记录的建议。
我们建议遵循他的建议:
我们只引用他收藏的第一部分:
良好ADR的特点:
- 理性:解释做特定AD的原因。这可以包括各种潜在选择的上下文、利弊、功能比较、成本/效益讨论等。
- 具体:每个ADR应该是关于一个AD,而不是多个AD。
- 时间戳:识别ADR中每个项目何时写入。这对于可能随着时间的推移而变化的方面尤为重要,例如成本、时间表、规模等。
- 不可变:不要更改ADR中的现有信息。相反,通过添加新信息来修改ADR,或通过创建新的ADR来取代ADR。