知识卡片
代码不讲全貌
内容
代码能显示实现，却难以解释系统如何融入环境、为什么选技术、组件如何部署、质量属性如何满足。发散：新成员读代码前若没有地图，会把大量时间耗在猜测设计意图上。
参考来源
- 位置：《程序员必读之软件架构》第46章《代码不会讲述完整的故事》（源文件：OEBPS/text00000_split_060.html）
- 结论依据：原文用新人加入网上银行系统项目、只能靠猜测项目命名约定和文件夹结构的例子，列出代码无法回答的一系列设计意图问题，直接支持卡片论点。
- 原始内容："代码不会讲述完整的故事。……软件系统如何融入已有的系统形态；为什么会选择正在使用的技术；软件系统的整体结构；……你不知道你未知的。……代码会讲故事，但不会讲述完整的故事。"