0°

共读DAY007《软件需求最佳实践》07


2016-10-08《软件需求最佳实践》徐锋著

第7章 需求描述最佳实践


需求描述就是将需求捕获、分析的结果进行文档化的过程。在软件开发时,将分析的结果文档化是不可或缺的任务,也称为编写规约活动;而在某个项目中,可能还会由用户代表或需求捕获人员对捕获的内容进行整理,形成用户需求说明书。

1需求描述的风格与格式


A常见的描述风格与选用标准


在描述需求时,最常见的描述风格可以分成自然语言、图形化模型和形式化规格描述3种,它们各有优缺点,通常我们会组合使用它们。

a自然语言

优点在于易于编写、易于阅读,不要求掌握特定的技能;但缺点在于不够严谨,歧义性强,表述力差(对于复杂问题的描述就更为明显,往往需要很大的篇幅来解释),因此我们需要尽可能采用结构化文本来组织。

b图形化模型

优点就是前面提到的可视性、聚焦性;但又存在明显的缺点,那就是要求编写和阅读的人都能够正确地理解模型,而且并不是所有的信息都是可以用模型表示的。

c形式化规格描述

优点就是严谨、精确;而其缺点也是很显然的,那就是编写和阅读的人都会感到很困难,容易产生理解歧义。

形式化规格描述有很多种:有简单的、应用于局部的决策图、决策表;类似于编程语言的、可应用于更广范围的伪码、Z语言等。


作者建议:

图形化模型为主,辅之以自然语言作为补充,需要的地方少量使用形式化规格描述:这是RUP所推荐的方法,当项目团队对模型标准有较高的认识时可以考虑这种方法,它在需求管理方面会更加方便一些,但出现交流障碍的可能性更高,特别是和最终用户代表的交流。

小婧:其实我觉得在写SRS的过程中,不可能全部都使用文字性的描述,因为这种方式很难说清楚稍微复杂一点的业务逻辑。我们要善于使用判断表(比如用于描述各角色权限),层级式的case描述,以及之前上一章所说的UML各种模型图表。

我们的目标是,让读者容易阅读和理解。就好像你去看代码,整段没有注释的代码可读性非常的差,而有层级关系及注释的代码看上去就很赏心悦目。


B典型软件需求规格说明书模板解析


除了确定风格之外,选择一个合适的软件需求规格说明书模板也是需求团队必须进行的一件事。在能够收集到的各种模板中,大致可以分成3类:

● 国标/ISO版本:由于是很早制定的(国际版本是1988年制定的,它参考了ISO组织20世纪70年代制定的标准),总体显得有点陈旧。

● RUP版本:由于其采用的模型为主的思路,因此文字部分的模板显得有点过于简单,无法涵盖所有需要的内容。

● 咨询商版本:其中Volere版本就是一个典型代表,它们有一个共同的特点,那就是比较追求通用性,有时难免出现“大而全”的弊端。

共读DAY007《软件需求最佳实践》07

小婧:作者针对每个SRS的目录及内容做了非常详细的说明,大家感兴趣可以自行参考比较。我目前使用的SRS模板就是参考了以上的版本,进行裁剪形成的。裁剪的主要原因是基于目前的产品复杂度、研发和需求沟通的有效性、需求人员能力。


C用户需求说明与软件需求规格说明


用户需求说明书,顾名思义就是用户对需求的说明与介绍,它的特点是更加面向业务,存在零散、可能相互矛盾等问题。因此通常不会称之为“用户需求规格说明书”,而是称之为“用户需求说明书”,也就是强调了达不到“契约”的等级。

共读DAY007《软件需求最佳实践》07


根据CMMI的描述,客户需求是通过采集项目相关人员的需要、期望、限制和接口,对其加以解释并转换而成的;而产品需求则是对客户需求进行提炼和细化而成的。

小婧:正如上一章提到的需求获取中所述,用户很多时候是描述不清楚自己的需求的,所以我们并不是太指望用户需求说明能给我们提供多大的助力。


2写作策略与技巧


A原则


● 简洁、段落文字少:也就是尽可能不要采用长篇大论的方法,因为段落越长,读者的压力越大,产生歧义的可能性也就越大。

● 列表、图表相结合的表示法:前一个指出了问题,这一个谈到了解决方法;要想避免出现长段落,最简单的方法就是通过分解成子需求列表的方法转换成一系列短句。

B措辞


对于非功能需求而言,应该抛弃定性,改用场景化描述;并通过选取指标、积累经验值的方法过渡到定量描述。

避免使用描述数据的词语

另一类容易产生歧义的是对数据规则进行描述的词语,例如:在……之间、但不包括,大于但不等于;这些都容易产生疏忽,因此我们应该改为使用数据表达式来说明。

小婧:这个部分需要各个需求人员自觉遵守了,很多时候我们发现不是SRS中没有描述,而是描述的不清楚。不想觉得“这么明显的事情,明显的逻辑,是个正常人都会知道……”千万不要这样想,否则,你会发现世界比你想象的要不正常的多。





小婧是一名行走在产品路上的资深业务分析师(BA),如果想与我同行,就请关注我吧!

共读DAY007《软件需求最佳实践》07






「点点赞赏,手留余香」

    还没有人赞赏,快来当第一个赞赏的人吧!
0 条回复 A 作者 M 管理员
    所有的伟大,都源于一个勇敢的开始!
欢迎您,新朋友,感谢参与互动!欢迎您 {{author}},您在本站有{{commentsCount}}条评论