知识卡片

普通读书笔记卡 · 2900.e

ADR记录为什么

理解等级:未标注

架构持续演进,我们会不断更新 Wiki 和文档,却常常忽略做出某个设计的原因。轻量级架构决策记录(ADR)用 Markdown 写成,与代码一起做版本管理,按顺序编号且编号不重复使用,记录影响架构、非功能需求、依赖、接口或构建系统的决策,每条包含标题、状态、背景、决策和结果等部分。发散:文档记录“是什么”,ADR 保留“为什么当时这样选”。

这张卡片看不懂?

已有反馈 · 0 / 10 条

    还没有人提交反馈。

    原书出处

    参考来源

    - 位置:《前端架构:从入门到微前端》第3章《架构基础:工作流设计》(源文件:_epub-src/OEBPS/Text/0006.xhtml) - 结论依据:原文说明架构持续演进,更新文档时常忽略做出设计的原因,因此要实施轻量级架构决策记录,用 Markdown 同代码一起版本化,按顺序编号且不重复,记录影响架构、非功能需求、依赖、接口或构建系统的内容。 - 原始内容:因此,我们需要在项目中实施轻量级架构决策记录。……这些记录包含了影响架构、非功能需求、依赖关系、接口或构建系统技术等内容。