知识卡片

普通读书笔记卡 · 1232.b.4

何时画图与何时不画

理解等级:中级

不要立“必须图示一切”这类硬规则,那只会把大量时间浪费在没人看的图上。是否画图取决于目的,并且每种情况都有明确的停止点:

可以画:

  • 几个人要同时使用设计的某部分,需要共同理解其结构;大家都理解后就停。
  • 两人以上对某元素的设计有分歧;设时间盒并选定投票或裁判等决策方式,到时或决定后就停,然后擦掉图。
  • 想尝试一个设计想法,图有助于思考;能用代码继续思考时就停,丢掉图。
  • 向别人或自己解释代码某部分的结构;浏览代码解释得更好时就停。
  • 接近项目尾声,客户要求把图作为文档交付。

不要画:

  • 只因为过程要求;
  • 不画就有负罪感,或觉得“好设计师就该画图”(好设计师写代码,只在必要时画图);
  • 为了在编码前产出面面俱到的设计阶段文档;
  • 为了让别人照着编码(真正的架构师要为自己的设计编码)。
这张卡片看不懂?

已有反馈 · 0 / 10 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 1 处

    • 第14章 使用UML · 查看原书依据

      不要硬性规定“必须图示一切”。这样的规则还不如没有规则。大量项目时间和精力会被浪费在绘制没人会看的图示上面。

    参考来源

    - 位置:《敏捷开发(纪念版)》第14章《第14章 使用UML》何时以及如何绘制图示(源文件:extracted/敏捷开发(纪念版)/_epub-src/Min Jie Kai Fa (Ji Nian Ban )_split_024.html,来源项目 book-sources) - 结论依据:原文反对必须图示一切的规则,列出可以画图的五种情形及各自的停止条件,以及因过程要求、负罪感、编码前全面设计文档、方便他人编码而画图的四种不应画情形。 - 原始内容:不要硬性规定“必须图示一切”。这样的规则还不如没有规则。大量项目时间和精力会被浪费在绘制没人会看的图示上面。