知识卡片
关于架构文档的三个误解
内容
三个看似理所当然、实则错误的架构主张：一，”每个项目都应该对架构编档”——就像不会给每天上下班这种低风险日常制订计划一样，是否值得建模要看问题本身；二，”架构文档应该综合全面”——多数情况下只需针对有风险的部分建模，如只有可伸缩性风险就只建可伸缩性模型；三，”设计必须先于编码”——早期编码反而常能帮你更快发现最难的问题，坚持”想清楚全部再动手”是对”没想清楚写不出代码”这一事实的过度引申。
参考来源
- 位置：《恰如其分的软件架构》第7章《软件架构的概念模型》章首引言（源文件：_epub-src/OEBPS/text00066.html）
- 结论依据：原文逐一列出并反驳三个似是而非的主张——每个项目都应编档、文档应综合全面、设计总先于编码，说明模型该按问题和风险取舍，早期编码常能发现最难的问题。
- 原始内容：每个项目都应当对架构进行编档：错误……架构文档应该综合全面：错误……设计总是先于编码：错误……事实上，早期编码能够帮助你发现最难的问题。