需求分析七宗罪之需求质量不高——易读性
第100期:需求质量不高
易读性是至关重要的。如果读者无法轻松理解所写之物,将会带来极大的困扰。然而,简单易懂并不意味着使用复杂的语言,而是要以符合可视化需求分析的方式来表达。
你写的东西要容易理解,否则对读者来说会非常困扰。要注意的是,简单易懂并不意味着要使用复杂的语言,而是要以符合可视化需求分析的方式来表达。
实例(一)
当角色是讲师的时候
且当作业的状态是 已通知讲师的时候
且当这个作业是这个讲师颁布的时候
讲师可以按下点评按钮
决策矩阵
在横向的状态下,状态和动作之间存在许可关系,可以执行左侧的动作。
无论是从易读性还是可维护性来看,可视化的表达方式都是更胜一筹的。
实例(二)
业务复杂的时候,“铛铛铛…”只会增加开发人员阅读时间,而且有的时候还容易理解错误。
实例(三)
IPO缩进表达方式:
泳道图表达方式:
【当前登录的用户】 如果上下文不明确,不清楚当前指的是哪个用户。使用更具体的描述【当前使用该系统的用户】可能更合适。
【之前的流程】 流程这个词过于抽象,有很多个前面的流程,不清楚具体指的是哪个。使用更具体的描述【之前的操作步骤】更好。
【现在的节点】 避免使用“现在”,以确保开发人员能够理解所指的时间范围。使用【当前的操作步骤】可以更清晰地表达。
除了内容上的调整,文档结构也非常重要。如果文档没有编号,读者在查找特定文档时会花费大量时间和精力。
此外,缺乏层级结构的文档会导致组成部分和层级关系变得混乱不清。产品经理应从易读性的角度考虑这些问题。
回复【电子书】领取需求分析实用技巧。数万名产品经理、BA汇聚地,深入需求分析与产品设计、产品运营,帮助你提升产品思维与洞察能力。原创知识体系:可视化需求分析。