知识卡片

普通读书笔记卡 · 5437

读者角色决定文档入口

理解等级:中级

项目经理需要分工、依赖和部署来排期;开发与维护者需要元素职责、接口、约束及理由;测试集成人员需要黑箱行为和可增量组合信息;外部系统设计者关心互操作契约;分析者需质量模型参数,运维需部署安装和配置变化。终端用户通常无需全部架构,但流程视图也可暴露误解。应识别真实读者,再按任务提供入口,而非统一发一套巨图。

这张卡片看不懂?

已有反馈 · 0 / 10 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 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.