adr 是编译中方便的架构决策记录方法,同时也纳入了技术雷达中,是一个很值得使用的模式
包含的内容
一般会包含标题,状态,上下文,决策,以及影响,aws 官方包含了很不错的例子,值得学习下
格式
对于存储格式没明确要求,实际上github 有一个adr 的组织,包含了不少实现工具,很值得参考学习
对于开发来说基于markdown 是一个不错的选择
说明
adr 方法,在不少技术架构书籍中有介绍,还是值得学习的,c4 模型也是一个描述架构的,结合起来还是很不错的
参考资料
https://adr.github.io/
https://docs.aws.amazon.com/prescriptive-guidance/latest/architectural-decision-records/appendix.html
https://www.ozimmer.ch/practices/2023/04/03/ADRCreation.html
https://c4model.com/