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