原则

——写作是一门艺术 ——文档化的目标是交流

技巧

1. 组织结构

? 内容位置安排得当 ? 引用或强化但不重复

2. 表达方式

? 根据内容，选择合适的方式 ? 使用系统的表达方式

3. 细节描述

? 定义术语表或数据字典 ? 避免干扰文本 ? 避免歧义词汇

思考题

1. 在需求获取和需求分析当中采用哪些手段可以保证最终需求集的完备性、一致性和正确性？ 解答：完备性，

需求规格说明文档时完备的，当且仅当1描述了用户所有有意义的需求，包括功能、性能、约束、质量属性和对外接口；2定义了软件对所有情况的所有实际输入（无论有效输入还是无效输入）的响应；3为文档中的所有插图、图、表和术语、度量单位的定义提供了完整的引用和标记。需求的完备性要求不能遗漏任何需求或者必要的信息，为避免需求遗漏，需求工程师要做好业务需求的分析，建立并控制正确的项目规范，建立业务需求、用户需求和系统需求的跟踪关系也用于发现需求的遗漏现象。文档内所有TBD（待解决问题）被全部解决之前，需求规格说明文档都是不完备的。

一致性，1细节的需求不能同高层次的需求相冲突，2同一层次的不同需求之间也不能互相冲突。也就是说，软件需求规格说明文档既要在所含内容上保持一致，也要和更高层次的文档（例如系统需求规格说明书）所含的内容保持一致。为保证需求规格说明文档的一致性，由开发人员和非开发人员对于其进行手工评审时非常必要的。 正确性，保证文档中每个单一需求都是优秀的需求。单一需求的优秀特性可以使整份文档满足正确性，无歧义和可验证。正确性是文档内的所有需求都有正确性，无歧义指的问胆囊管选中的指令，可验证文档内所有的所有需求都是可验证的

~ 37 ~

第16章 需求验证

1. 多种需求验证的方法应该如何结合运用？ 解答：

需求验证的方法：需求评审（静态分析，需求验证的一种主要方法）， 原型与模拟，开发测试用例，用户手册编制，利用跟踪关系，自动化分析

每个需求都需要经过评审，对于动态行为评审不能完成的就要通过原型和模拟的方法来验证。在正常的工作当中，可以顺便用上用户手册，测试用例，跟踪等方法在一些错误之处或者一些需求上进行验证，也是比较有效的。总而言之，大多数情况下，需求都是在静态的方式下被加以验证的（评审的方法），也可以说几乎说的需求都要经过评审的方法进行验证，个别动态复杂的需求需要用原型与模拟的方法进行验证，工作之间产生的衔接可以用上开发测试用例，用户手册等方法，这样可以实现高效的综合运用。

~ 38 ~