知识卡片
读者角色决定文档入口
项目经理需要分工、依赖和部署来排期;开发与维护者需要元素职责、接口、约束及理由;测试集成人员需要黑箱行为和可增量组合信息;外部系统设计者关心互操作契约;分析者需质量模型参数,运维需部署安装和配置变化。终端用户通常无需全部架构,但流程视图也可暴露误解。应识别真实读者,再按任务提供入口,而非统一发一套巨图。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
原书出处 · 1 处
- 记录架构文档 · 查看原书依据
Understanding the uses of architecture documentation is essential, as those uses determine the important information to capture. Fundamentally, architecture documentation has four uses. 1. Architecture documentation serves as a means of education.
参考来源
- 位置:《Software Architecture in Practice, 4th Edition》第22章《记录架构文档》(来源项目:book-sources;源文件:extracted/Software Architecture in Practice, 4th Edition/_epub-src/ch22.html)
- 结论依据:原文解释项目经理需要分工、依赖和部署来排期;开发与维护者需要元素职责、接口、约束及理由;测试集成人员需要黑箱行为和可增量组合信息;外部系统设计者关心互操作契约;分析者需质量模型参数,运维需部署安装和配置变化;本章后续机制、例子与条件共同限定本卡,原书经验数字和前景不视为当前实测或现状。
- 原始内容:Understanding the uses of architecture documentation is essential, as those uses determine the important information to capture. Fundamentally, architecture documentation has four uses. 1. Architecture documentation serves as a means of education.