知识卡片

普通读书笔记卡 · 5454.a.1.j.1.c.1

分层次描述,比合并描述"设计"与"构建方式"更容易理解

理解等级:未标注

一份糟糕规格说明书的典型陷阱,是试图在同一份文档、甚至同一页内,既描述”这个东西设计成什么样”,又说明”应该如何构建它”——一位既精明又有才能的撰写者,用大幅精细的图表既表现对象和组件之间的关系,又从客户使用角度绘制图解,最终产出的文档看起来令人印象深刻,但读者读五分钟就会陷入挫败和困惑,团队反应普遍负面。这类失败的关键症结不在于两种信息本身不该同时存在,而在于假设”读者同时需要这两种信息”就等于”应该把它们放在同一页里呈现”——这是一个错误的推论。真正有效的做法是以不同层次分开描述设计:首先用客户的语言描述客户会经历什么;其次从高层次角度呈现基本对象和架构;最后再涵盖复杂详细的工程设计问题。以单一层次的思路来撰写、阅读、逐层处理,通常比把多个层次的信息硬塞进同一段落容易得多——这个道理和阅读复杂逻辑或数学材料时的规律相通:最好的教师懂得何时该跳过某些暂时不重要的细节、又该在读者准备好时再回过头来补充,撰写规格说明书时同样需要运用这种”分层次揭示”的技巧,而不是试图一次性把所有信息压缩进同一个视角里呈现。

这张卡片看不懂?

已有反馈 · 0 / 10 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 1 处

    参考来源

    - 位置:《项目管理之美》第7章《撰写优秀的规格说明书》"描述最终设计和如何构建"一节(源文件:_epub-src/OEBPS/Text/part0062.xhtml) - 结论依据:原文详细描述了一份试图同时描述设计和构建方式的规格说明书如何造成团队困惑和挫败,并明确指出"即使有人需要这两种信息,也没有理由假设他会同时需要,或者需要把它们放在同一页……良好的规格说明书通常会以不同层次来描述设计:首先,用客户的语言来描述客户的经验是什么;其次,从高层次角度观察基本对象和架构;最后,涵盖复杂和详细的工程设计问题",直接支撑本卡片结论。 - 原始内容:即使有人需要这两种信息,也没有理由假设他会同时需要,或者需要把它们放在同一页