知识卡片

普通读书笔记卡

先写文字用例说明书再画活动图避免布局工作分散对描述本身的专注

理解等级:未标注

用活动图取代传统文字形式的用例说明书,确实能让描述更简洁清晰—— 但书中特别提醒了一个建模者常踩的顺序陷阱:不少建模者会在脑子里 刚开始构思用例描述的时候,就直接打开建模工具画活动图,这种做法 反而会阻碍创造力。原因在于两种活动占用的认知资源完全不同:撰写 文字描述时,思考的焦点是”执行者和系统之间到底应该如何正确、 清晰地交互”这个内容问题;而一旦切换到建模工具画图,注意力会 不知不觉地被图的布局——节点摆在哪里、连线怎么走、空间够不够 用——这类形式问题占据,导致本该花在把交互逻辑想清楚上的精力 被稀释掉了。因此更好的顺序是:先用文字模板(用例名称、范围、 主执行者、预置条件、主要成功场景等字段)把描述写下来,并和 利益相关者一起打磨这份文字描述,直到内容本身足够清晰、正确; 只有在这一步完成之后,再用建模工具把已经想清楚的描述转换成 活动图做可视化呈现。这个顺序建议背后的一般性道理是:内容的 思考和形式的呈现是两种不同性质的认知负荷,过早引入形式层面的 工具操作,会挤占本该分配给内容质量的注意力。

这张卡片看不懂?

已有反馈 · 0 / 10 条

    还没有人提交反馈。

    原书出处

    参考来源

    - 位置:《SysML精粹》第5章"用例图"5.3.1节"用例说明书"(源文件: _epub-src对应text00028.html一带) - 结论依据:原文明确"活动图要比传统文字形式的用例说明书更 简洁、更清晰。因此,很多建模者会犯这样的错误,在头脑构思用例 描述的时候就使用建模工具创建活动图。这种实践会阻碍创造力。 你需要首先关注描述;撰写好文字描述……一旦你开始创建活动图, 就会花费大量时间和精力在活动图的布局上,那会让你无法专心 进行清晰、正确的说明",直接支撑先写文字说明书、再画活动图、 避免过早陷入布局工作这一结论。 - 原始内容:一旦你开始创建活动图,就会花费大量时间和精力在 活动图的布局上,那会让你无法专心进行清晰、正确的说明。我总是 建议团队中的设计师首先以文字形式记录描述……然后再使用建模 工具在活动图上以可视化的方式来表达那些描述。