写好 ADR 个建议

好 ADR 个特点：

• 理据：讲清爽做迭个架构决策个理由。可以包括背景（见下底）、各种可能选择个利弊、功能比较、成本／收益讨论等等。

• 具体：每份 ADR 只讲一个架构决策，勿要讲好几个。

• 时间戳：标明 ADR 里每一项是啥辰光写个。对会随辰光变化个方面特别重要，比方成本、日程、扩展等等。

• 勿可变：勿要改 ADR 里现成个信息。要么加新信息来修订 ADR，要么新建一份 ADR 来取代伊。

ADR 里好个“背景”章节个特点：

• 讲清爽侬组织个情况搭业务优先级。

• 包括根据团队个社交搭技能构成得出个理据搭考虑。

• 包括相关个利弊，用搭侬个需求搭目标一致个方式来描述。

ADR 里好个“后果”章节个特点：

• 讲清爽做了迭个决策之后会发生啥。可以包括影响、结果、产出、后续跟进等等。

• 包括任何后续 ADR 个信息。一份 ADR 引出更加多 ADR 是蛮常见个，比方一份 ADR 做了一个大个总体选择，伊又带来更加多较小决策个需要。

• 包括任何事后回顾个流程。团队一般辣一个月之后回顾每份 ADR，拿 ADR 里个信息搭实际发生个情况比一比，用来学习搭成长。

新 ADR 可以取代之前个 ADR：

• 做了一个取代或者推翻之前 ADR 个架构决策，就应该新建一份 ADR