主要观点:在系统中遇到困惑时,“事情能否改变”这个问题可能最紧迫,可能需通过科学研究来寻找答案,而目前重点是解决其他关于决策的问题,沟通决策很关键,架构决策记录(ADRs)能提供帮助,包括记录决策的标准格式、流程等,用代码注释类比说明要记录“为什么”做某事,推荐使用[Nat Pryce 的 adr-tools],ADR 需包含上下文、决策、后果三部分,且是一个动态系统,即使项目未做过 ADRs,也可从下一个大决策开始制作,ADRs 虽不能保证完全解决疑惑,但能让事情更易处理。
关键信息:
- 遇到系统困惑时的思考及问题。
- ADRs 的作用和包含内容。
- 推荐的 adr-tools 及其特点。
- ADRs 三部分的重要性及作用。
- 项目未做 ADRs 时的应对方法。
重要细节:
- 决策需清晰明确,上下文要理解决策背后原因及指出其他选项,后果要列出利弊。
- ADRs 可记录历史决策,虽可能因缺乏信息而不清晰,但仍有帮助。
- 可随时开始制作 ADRs,为后续决策提供参考。
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。