知识卡片
文档帮助形成共同理解
快速变化的服务需要持续更新架构、请求流、依赖、上手指南和运行手册。文档的价值不只是保存文字,还在于让团队对真实服务形成一致认识;把成员聚在一起画架构图,可以暴露彼此理解的缺口。维护文档应随设计和运行变化进行,而非只在项目结束时补写。
这张卡片看不懂?
这张卡片的反馈已满 10 条,暂时无法继续提交。
已有反馈 · 0 / 10 条
还没有人提交反馈。
在整书笔记中的位置
原书出处 · 1 处
- 生产就绪 · 查看原书依据
为了说明这一点,我们可以想象一下开发人员在一起工作的情景,他们彼此分享着对微服务的理解。你可以试着让你的团队坐在一个房间里,在一块白板前面,让他们把系统架构和微服务相关的重要细节画在白板上。我相信你会对结果感到吃惊,你会发现他们对微服务的理解不在一个频道上。有人知道其他人所不知道的,也有人对微服务的理解让你不禁要怀疑他是否在开发这个微服务。在审查代码变更、更换新技术、增加新功能的时候,对各方面知识理解的不一致会导致微服务无法达到生产就绪
参考来源
- 位置:《生产微服务》第2章《生产就绪》(来源项目:a19c7933-4eda-4176-aebd-30fe7e1ad292;源文件:extracted/生产微服务/_epub-src/OEBPS/text00006.html)
- 结论依据:原文围绕“对各方面知识理解的不一致会导致微服务无法达到生产就绪标准”及紧邻论述说明本卡的对象、作用和约束,本卡据此归纳,不把案例推为所有架构的保证。
- 原始内容:为了说明这一点,我们可以想象一下开发人员在一起工作的情景,他们彼此分享着对微服务的理解。你可以试着让你的团队坐在一个房间里,在一块白板前面,让他们把系统架构和微服务相关的重要细节画在白板上。我相信你会对结果感到吃惊,你会发现他们对微服务的理解不在一个频道上。有人知道其他人所不知道的,也有人对微服务的理解让你不禁要怀疑他是否在开发这个微服务。在审查代码变更、更换新技术、增加新功能的时候,对各方面知识理解的不一致会导致微服务无法达到生产就绪