← 返回起始笔记位置

知识卡片

普通读书笔记卡 · 2274.e.1.b.2.b

文档帮助形成共同理解

理解等级:中级

快速变化的服务需要持续更新架构、请求流、依赖、上手指南和运行手册。文档的价值不只是保存文字,还在于让团队对真实服务形成一致认识;把成员聚在一起画架构图,可以暴露彼此理解的缺口。维护文档应随设计和运行变化进行,而非只在项目结束时补写。

这张卡片看不懂?

已有反馈 · 0 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 1 处

    • 生产就绪 · 查看原书依据

      为了说明这一点,我们可以想象一下开发人员在一起工作的情景,他们彼此分享着对微服务的理解。你可以试着让你的团队坐在一个房间里,在一块白板前面,让他们把系统架构和微服务相关的重要细节画在白板上。我相信你会对结果感到吃惊,你会发现他们对微服务的理解不在一个频道上。有人知道其他人所不知道的,也有人对微服务的理解让你不禁要怀疑他是否在开发这个微服务。在审查代码变更、更换新技术、增加新功能的时候,对各方面知识理解的不一致会导致微服务无法达到生产就绪

    参考来源

    - 位置:《生产微服务》第2章《生产就绪》(来源项目:a19c7933-4eda-4176-aebd-30fe7e1ad292;源文件:extracted/生产微服务/_epub-src/OEBPS/text00006.html) - 结论依据:原文围绕“对各方面知识理解的不一致会导致微服务无法达到生产就绪标准”及紧邻论述说明本卡的对象、作用和约束,本卡据此归纳,不把案例推为所有架构的保证。 - 原始内容:为了说明这一点,我们可以想象一下开发人员在一起工作的情景,他们彼此分享着对微服务的理解。你可以试着让你的团队坐在一个房间里,在一块白板前面,让他们把系统架构和微服务相关的重要细节画在白板上。我相信你会对结果感到吃惊,你会发现他们对微服务的理解不在一个频道上。有人知道其他人所不知道的,也有人对微服务的理解让你不禁要怀疑他是否在开发这个微服务。在审查代码变更、更换新技术、增加新功能的时候,对各方面知识理解的不一致会导致微服务无法达到生产就绪