知识卡片
ADR指南先列判断条件
面对“取决于场景”的 API 架构选择,可以先把待决定的问题、需要讨论的条件和有依据的建议列成指南,再针对具体系统写 ADR。指南负责提示应核对哪些约束,ADR 记录本次实际选择及后果。这样既避免把一般建议当成固定答案,也让下一次类似决策有可复用的提问框架。
这张卡片看不懂?
这张卡片的反馈已满 10 条,暂时无法继续提交。
已有反馈 · 0 / 10 条
还没有人提交反馈。
在整书笔记中的位置
- · 把取舍留下来
原书出处 · 1 处
- · 查看原书依据
Rather than say it depends without context, the ADR Guidelines will help describe what it depends on and help inform your decisions. The ADR Guidelines can be used as a reference point to come back to or to read ahead to if you’re facing a specific challenge.
参考来源
- 位置:《Mastering API Architecture》导言《Introduction》之《Mastering API: ADR Guidelines》(源文件:_epub-src/OEBPS/introduction01.xhtml)
- 结论依据:原文把 ADR Guidelines 设计成处理“it depends”的参考框架,列出 Decision、Discussion Points、Recommendations 三项,并说明其目的是为具体决策提供应讨论的信息。
- 原始内容:Rather than say it depends without context, the ADR Guidelines will help describe what it depends on and help inform your decisions. The ADR Guidelines can be used as a reference point to come back to or to read ahead to if you’re facing a specific challenge.