知识卡片
文档引用事实
内容
软件架构文档应当组织和引用关键工作产品,而不是把需求、模型、决策和验证材料全部复制一遍。这样既能形成可交付的架构叙事,又能避免事实在多个文档中漂移。发散:好的架构文档像索引和地图,帮助人找到证据,而不是制造第二套事实。
参考来源
- 位置:《架构实战:软件架构设计的过程》第4章《编写软件架构文档》4.7节“软件架构文档”(源文件:_chapter-text/ch04.txt)
- 结论依据:原文明确指出软件架构文档主要是参考其他工作产品,而不是重做这些工作产品中定义的内容,支持“文档引用事实”这一论点。
- 原始内容:正如第3章中讨论的,软件架构文档主要是参考其他工作产品,而不是重做这些工作产品中定义的内容。