知识卡片
ADR四段结构
一份 ADR 可用状态、背景、决定、后果四段组织。状态说明提案是否已被接受或取代;背景限定要解决的问题;决定写清做法;后果揭示引入的风险和取舍。记录若只写“采用什么技术”而省略背景和后果,后来者便无法判断该决定是否仍适用。
这张卡片看不懂?
这张卡片的反馈已满 10 条,暂时无法继续提交。
已有反馈 · 0 / 10 条
还没有人提交反馈。
在整书笔记中的位置
- · 把取舍留下来
原书出处 · 1 处
- · 查看原书依据
There are four key sections in an ADR: status, context, decision, and consequences. An ADR is created in a proposed status and based on discussion will usually be either accepted or rejected. It is also possible that the decision may be superseded later by a new ADR.
参考来源
- 位置:《Mastering API Architecture》导言《Introduction》之《Using Architecture Decision Records》(源文件:_epub-src/OEBPS/introduction01.xhtml)
- 结论依据:原文明确列出 ADR 的 status、context、decision、consequences 四部分,并解释背景、决定与后果各自承载的信息。
- 原始内容:There are four key sections in an ADR: status, context, decision, and consequences. An ADR is created in a proposed status and based on discussion will usually be either accepted or rejected. It is also possible that the decision may be superseded later by a new ADR.