需求文档中的用例为什么不适合用户看,为什么用户看不懂?解决办法
需求文档中的用例为什么不适合用户看,为什么用户看不懂?
引言:听完徐峰老师的需求分析培训课程,感觉对软件需求又有了新的领悟.
国内做需求分析的人都没掌握需求分析的要点,写的需求分析说明书用户看不懂,其中一个误区
就是写一些连自已都不愿看,没弄明白的用例图给用户看.
以大学生入学登记为例,如果我通过给一个从未经历过的人描述,让他听明白.如何办?
其一: 通过流程描述: (以下是随意杜撰的)
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页
三小时仍未讲完...
听者发狂,我打...
我如果是这个听者,一定当场晕倒!
国内做需求的人写的文档就是这样让软件客户看的.
------解决方案--------------------
------解决方案--------------------
1、写用例文档时要清楚这个文档是给谁看的，一般来说就算用户不看你也要做到客户能够看懂，换句话说就是这个文档要做到技术无关，业务相关，文档中描述的是用户目标、操作流程、业务规则、输入输出这些东西。
2、用户肯定不会一上手就能看懂，对用户要进行用例文档阅读的培训，而这个培训个把小时就够了，除非你的用例文档太过于复杂。
3、如楼上所说，有可能遇到各种人，如果真的秀才遇上兵，这时候用例文档主要用来分析人员理清自己的思路，然后通过语言交流不断挖掘、修正用例
------解决方案--------------------
哇哈哈，我正要开始写个别人看不懂的东西出来了
就像sp1234说的，无关紧要的细节就可以不要了。
画完了图给上边的看，立马被退回了，理由就是不够全面
哎~~~~~~
引言:听完徐峰老师的需求分析培训课程,感觉对软件需求又有了新的领悟.
国内做需求分析的人都没掌握需求分析的要点,写的需求分析说明书用户看不懂,其中一个误区
就是写一些连自已都不愿看,没弄明白的用例图给用户看.
以大学生入学登记为例,如果我通过给一个从未经历过的人描述,让他听明白.如何办?
其一: 通过流程描述: (以下是随意杜撰的)
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页
三小时仍未讲完...
听者发狂,我打...
我如果是这个听者,一定当场晕倒!
国内做需求的人写的文档就是这样让软件客户看的.
------解决方案--------------------
------解决方案--------------------
1、写用例文档时要清楚这个文档是给谁看的，一般来说就算用户不看你也要做到客户能够看懂，换句话说就是这个文档要做到技术无关，业务相关，文档中描述的是用户目标、操作流程、业务规则、输入输出这些东西。
2、用户肯定不会一上手就能看懂，对用户要进行用例文档阅读的培训，而这个培训个把小时就够了，除非你的用例文档太过于复杂。
3、如楼上所说，有可能遇到各种人，如果真的秀才遇上兵，这时候用例文档主要用来分析人员理清自己的思路，然后通过语言交流不断挖掘、修正用例
------解决方案--------------------
哇哈哈，我正要开始写个别人看不懂的东西出来了
就像sp1234说的，无关紧要的细节就可以不要了。
画完了图给上边的看，立马被退回了，理由就是不够全面
哎~~~~~~