知识卡片
代码无法替代设计沟通
让新人只读源代码来理解系统看似省事(代码已存在,不消耗团队精力),实际有明显局限:目录结构只是设计线索,不能直接等同于模块划分或依赖关系;更关键的是模型与代码之间存在差距——团队讨论设计决策时权衡的取舍、审慎考虑的约束,往往从未在代码里留下痕迹,这些”为什么这样设计”的意图只存在于讨论本身。源代码在”模块视图+代码模型”表现尚可,但不足以独自清楚传达运行时、部署和领域的全部意图;开发者仍可从代码取得部分线索。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
- · 4.1 团队沟通
原书出处 · 1 处
- · 查看原书依据
目录结构也不能表达模块之间的依赖关系。
参考来源
- 位置:《恰如其分的软件架构》第4章《实例:家庭媒体播放器》4.1.1节《阅读源代码》(源文件:_epub-src/OEBPS/text00043.html)
- 结论依据:原文说明代码作为唯一沟通工具的局限——模型与代码之间存在差距,设计意图无法在代码中呈现,且源代码只能在模块视图和代码模型中起到交流作用,对运行时视图、部署视图等力不从心。
- 原始内容:我们都很明确模型与代码之间存在差距……作为一个团队,我们讨论设计决策,寻求平衡,审慎地考虑设计约束,但这些内容却无法在代码中呈现……在其他视图类型(运行时视图与部署视图)及其他主要的模型(领域模型与设计模型)中,就显得力不从心了。