← 返回起始笔记位置

知识卡片

普通读书笔记卡 · 1958.d.2

渐进式文档创建策略

理解等级:未标注

面对”如何向新人传达设计”这类没有单一明确解法的风险,可按成本从低到高逐步添加文档,每加一部分就重新评估风险是否已缓解,用”三个主要模型+三种视图类型”的覆盖率作为进度尺度:先给模块模型(成本最低),再给质量属性优先级和设计决策说明(代码里看不出的取舍原因),再给运行时职责列表和功能场景,本例因只有单机且部署已清楚而省略部署图。覆盖模型/视图是本例评估沟通的辅助尺度,仍需判断新人是否理解;不是填满清单就自动消除风险。

这张卡片看不懂?

已有反馈 · 0 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 1 处

    • · 查看原书依据

      每增加一部分内容,就需要叩问我们自己,风险是否已经得到充分的缓解

    参考来源

    - 位置:《恰如其分的软件架构》第4章《实例:家庭媒体播放器》4.1节《团队沟通》、4.1.5节《反思》(源文件:_epub-src/OEBPS/text00043.html) - 结论依据:原文描述团队按模块模型→质量属性与设计决策→运行时模型的顺序逐步添加文档,每次都用视图类型与模型的覆盖率重新评估沟通风险是否缓解,一旦覆盖主要模型和视图类型就停止。 - 原始内容:我们可以先从代价小的技术开始,然后再选择成本较高的技术,直到认为风险已然消除为止……我们可以先从创建最为简单的文档开始,然后逐渐添加那些更有价值的内容……一旦我们覆盖了主要的模型和视图类型,就可以暂告一个段落。