知识卡片

文档引用事实

普通读书笔记卡 · 1826.a

内容

软件架构文档应当组织和引用关键工作产品,而不是把需求、模型、决策和验证材料全部复制一遍。这样既能形成可交付的架构叙事,又能避免事实在多个文档中漂移。发散:好的架构文档像索引和地图,帮助人找到证据,而不是制造第二套事实。

参考来源

- 位置:《架构实战:软件架构设计的过程》第4章《编写软件架构文档》4.7节“软件架构文档”(源文件:_chapter-text/ch04.txt) - 结论依据:原文明确指出软件架构文档主要是参考其他工作产品,而不是重做这些工作产品中定义的内容,支持“文档引用事实”这一论点。 - 原始内容:正如第3章中讨论的,软件架构文档主要是参考其他工作产品,而不是重做这些工作产品中定义的内容。