如何让需求说明更好用?

好用的需求说明应当具备以下特征:

  • 需求描述准确、可靠、一致、无歧义
  • 需求满足各利益相关方的要求
  • 易于理解
  • 便于使用和维护

实例化需求说明方法有很多实践可以帮助我们达成以上目标。

  1. 活文档

需求说明应当是协作开发的,是代表各个利益相关方要求的,各个利益相关方对需求理解是一致的,需求说明是在开发过程中被频繁验证过的活文档。

  1. 统一语言

需求说明最好采用一种能够被各个利益相关方容易理解的统一语言来描述。使用统一语言来描述需求,可以更便于利益相关方交流和沟通需求。

  1. 文档结构

好用的需求说明还应当具备一个好的文档结构。一个好的文档结构可以让需求说明脉络清晰,易于理解和使用。需求说明可以采用以下的文档结构:

  • 按照用户故事的层次和类别来组织
  • 按照功能需求的层次来组织
  • 按照用户界面的导航结构来组织
  • 按照用户的业务流程来组织
  1. 功能分解

太过冗长的描述容易让人昏昏欲睡。需求说明要追求精炼。如果一个功能很大,就应将它分解成多个小的功能进行描述,避免一个功能占用巨大的篇幅。

  1. 实例化

需求不仅仅有综合性的描述,还应尽可能地给出具体的实例。实例化的需求说明简单、明了,不会产生歧义,也便于进行验证。

  1. 链接

需求说明除了使用有效的文档结构组织起来,还可以在文档中使用链接的方式来组织。比如,将文中的术语或引用的子功能等事项采用标签和链接的方式组织起来,这样的文档清爽、整洁,更便于对需求的阅读和理解。

总之,不管我们是否应用实例化需求说明,我们都可以从中选取一些优秀的实践使得我们的需求说明更好用。毕竟,追求需求的简洁、高效、可靠、好用,是我们共同的目标。

这正是:

需求说明要好用,几个实践可建功

统一语言实例化,结构分解用链接

参考书目:实例化需求:团队如何交付正确的软件,作者:(塞尔维亚)Gojko Adzic,出版社:人民邮电出版社


作者简介:王小双,长期从事GJB5000推广、实施、评价、改进的工作,创建《软件工程之思》微信公众号,一直在《软件工程之思》分享GJB5000、CMMI、软件工程的知识和感悟。现致力于GJB5000咨询以及软件过程改进、软件工程能力提升的研究工作。

发表评论

登录后才能评论
联系杨振
联系杨振
侵权联系 投诉举报
分享本页
返回顶部