← 返回刚才阅读的位置

知识卡片

普通读书笔记卡 · 2274.e.1.c.3

接口文档解释可依赖行为

理解等级:中级

接口文档要同时描述请求经过的步骤、每个端点的输入输出和所调用的依赖。依赖资料还应说明相关端点、SLA、替代方案与监控入口。这样调用者可以理解外部行为,开发者也能追踪内部路径,避免把黑盒使用误解为可以忽视依赖约束。

这张卡片看不懂?

已有反馈 · 0 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 1 处

    • 文档化和理解 · 查看原书依据

      请求消息流的文档里可以包含请求流程图。如果架构图里已经详细描述了请求消息流,那么可以把架构图放在这里。流程图需要有相应的文字描述,比如请求的类型以及它们是如何被处理的。

    参考来源

    - 位置:《生产微服务》文档化和理解(来源项目:a19c7933-4eda-4176-aebd-30fe7e1ad292;源文件:extracted/生产微服务/_epub-src/OEBPS/text00011.html) - 结论依据:术语含义与相关正文合读,区分定义、目的及其实际适用边界,不把示例比例或工具选择当作普遍定律。 - 原始内容:请求消息流的文档里可以包含请求流程图。如果架构图里已经详细描述了请求消息流,那么可以把架构图放在这里。流程图需要有相应的文字描述,比如请求的类型以及它们是如何被处理的。