知识卡片
ADR记录为什么
架构持续演进,我们会不断更新 Wiki 和文档,却常常忽略做出某个设计的原因。轻量级架构决策记录(ADR)用 Markdown 写成,与代码一起做版本管理,按顺序编号且编号不重复使用,记录影响架构、非功能需求、依赖、接口或构建系统的决策,每条包含标题、状态、背景、决策和结果等部分。发散:文档记录“是什么”,ADR 保留“为什么当时这样选”。
这张卡片看不懂?
这张卡片的反馈已满 10 条,暂时无法继续提交。
已有反馈 · 0 / 10 条
还没有人提交反馈。
原书出处
参考来源
- 位置:《前端架构:从入门到微前端》第3章《架构基础:工作流设计》(源文件:_epub-src/OEBPS/Text/0006.xhtml)
- 结论依据:原文说明架构持续演进,更新文档时常忽略做出设计的原因,因此要实施轻量级架构决策记录,用 Markdown 同代码一起版本化,按顺序编号且不重复,记录影响架构、非功能需求、依赖、接口或构建系统的内容。
- 原始内容:因此,我们需要在项目中实施轻量级架构决策记录。……这些记录包含了影响架构、非功能需求、依赖关系、接口或构建系统技术等内容。