最佳实践

提升所有权。每个项目团队成员都应有权创建和拥有 ADR。这种做法将架构研究工作分配给团队成员，减轻了解决方案架构师或团队负责人的工作负担。它还能培养决策过程中的主人翁意识。这有助于团队更快地采纳这些决策，而不是将其视为组织高层强加的决策。

保存 ADR 历史记录。 ADRs 应该有变更历史记录，每个变更都应该有一个所有者。当 ADR 所有者更新 ADR 时，他们应将旧 ADR 的状态更改为已取代，在新 ADR 的更改历史记录中记录更改，并将旧 ADR 保留在决策日志中。

安排定期审查会议。如果您正在进行一个新的（新建）项目，ADR 流程一开始可能会非常复杂。我们建议您在每日例会之前或之后定期召开 ADR 讨论和审查会议。通过这种方法，定义的 ADRs 将在两三次冲刺中稳定下来，并且您可以用更少的会议来打下坚实的基础。

存 ADRs 放在中心位置。每个项目成员都应有权访问该集合 ADRs。我们建议您将它们存储 ADRs 在中央位置，并在项目文档的主页上进行参考。有两种常用的存储选项 ADRs：

• 一个 Git 存储库，可以更轻松地进行版本控制 ADRs

• 一个 wiki 页面，所有团队成员 ADRs 都可以访问

解决不合规代码。ADR 流程并不能解决遗留代码不合规的问题。如果您的旧代码不支持已建立的代码 ADRs，则可以逐步更新过时的代码库或工件，同时引入新的更改，或者您的团队可以决定通过创建技术债务任务来明确重构代码。