知识卡片

普通读书笔记卡 · 3214

ADR指南先列判断条件

理解等级:中级

面对“取决于场景”的 API 架构选择,可以先把待决定的问题、需要讨论的条件和有依据的建议列成指南,再针对具体系统写 ADR。指南负责提示应核对哪些约束,ADR 记录本次实际选择及后果。这样既避免把一般建议当成固定答案,也让下一次类似决策有可复用的提问框架。

这张卡片看不懂?

已有反馈 · 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.