需求文档中的用例为什么不适合用户看,为什么用户看不懂?解决办法

需求文档中的用例为什么不适合用户看,为什么用户看不懂?
引言:听完徐峰老师的需求分析培训课程,感觉对软件需求又有了新的领悟.

  国内做需求分析的人都没掌握需求分析的要点,写的需求分析说明书用户看不懂,其中一个误区
就是写一些连自已都不愿看,没弄明白的用例图给用户看.

  以大学生入学登记为例,如果我通过给一个从未经历过的人描述,让他听明白.如何办? 
  其一: 通过流程描述: (以下是随意杜撰的)
  1.先到教务处注册,领取学生证,宿舍钥匙
  2.到财务处交学费
  3.到后勤处领取生活用品,
  4.等等.
  三分钟讲完

  其二: 用例描述 (以下是随意杜撰的)
  1.教务处有四功能 A功能为学生注册, B功能是申请助学贷款, C功能是勤工俭学支持, D为注销学籍
  A功能细节参考附件 <<部门职责手册>> 120页
  2.财务处提供八大功能,包括A.收学费,B.退多余学费,C.收培训费, D.给老师发工资. F.给校长报销车费
  A功能细节参考附件 <<岗位职责手册>> 220页
  3.后勤提供十大功能,A.宿舍卫生检查, B.新生领取生活用品, C.门卫管理 ...
  另附参考手册, 用例描述中细节不清参考文档:
  <<部门职责手册>>100页
  <<岗位职责手册>>230页
  三小时仍未讲完...
  听者发狂,我打...

  我如果是这个听者,一定当场晕倒! 

  国内做需求的人写的文档就是这样让软件客户看的.

[解决办法]

引用楼主 slxys 的帖子:

引言:听完徐峰老师的需求分析培训课程,感觉对软件需求又有了新的领悟.

国内做需求分析的人都没掌握需求分析的要点,写的需求分析说明书用户看不懂,其中一个误区
就是写一些连自已都不愿看,没弄明白的用例图给用户看.

以大学生入学登记为例,如果我通过给一个从未经历过的人描述,让他听明白.如何办?
其一: 通过流程描述: (以下是随意杜撰的)
1.先到教务处注册,领取学生证,宿舍钥匙
2.到财务处…

[解决办法]
1、写用例文档时要清楚这个文档是给谁看的，一般来说就算用户不看你也要做到客户能够看懂，换句话说就是这个文档要做到技术无关，业务相关，文档中描述的是用户目标、操作流程、业务规则、输入输出这些东西。
2、用户肯定不会一上手就能看懂，对用户要进行用例文档阅读的培训，而这个培训个把小时就够了，除非你的用例文档太过于复杂。
3、如楼上所说，有可能遇到各种人，如果真的秀才遇上兵，这时候用例文档主要用来分析人员理清自己的思路，然后通过语言交流不断挖掘、修正用例

[解决办法]
哇哈哈，我正要开始写个别人看不懂的东西出来了
就像sp1234说的，无关紧要的细节就可以不要了。
画完了图给上边的看，立马被退回了，理由就是不够全面
哎~~~~~~

查看更多 下一篇