提示9-9:遵循_建议以获得良好的ADR_

提示9-9:遵循_建议以获得良好的ADR_

#decision #adr

架构决策记录的支持者之一乔尔·帕克·亨德森收集了关于良好架构决策记录的建议。

我们建议遵循他的建议:

我们只引用他收藏的第一部分:

良好ADR的特点:

  • 理性:解释做特定AD的原因。这可以包括各种潜在选择的上下文、利弊、功能比较、成本/效益讨论等。
  • 具体:每个ADR应该是关于一个AD,而不是多个AD。
  • 时间戳:识别ADR中每个项目何时写入。这对于可能随着时间的推移而变化的方面尤为重要,例如成本、时间表、规模等。
  • 不可变:不要更改ADR中的现有信息。相反,通过添加新信息来修改ADR,或通过创建新的ADR来取代ADR。