软件工程与计算总结（七）需求文档化与验证

目录

一.文档化的原因

二.需求文档基础

1.需求文档的交流对象

2.用例文档

3.软件需求规格说明文档

三.需求文档化要点

1.技术文档协作要点

2.需求书写要点

3.软件需求规格说明文档属性要点

四.评审软件需求规格说明文档

1.需求验证与确认

2.评审需求的注意事项

五.以需求为基础开发系统测试用例

1.开发测试用例套件（以需求为线索）

2.开发测试用例（使用测试技术确定输入输出数据）

六.度量需求

七.将需求制品纳入配置管理

---

 

一.文档化的原因

在软件开发过程中，任务可以分解为多个自任务分配给不同的人员，但是分解的子任务之间需要沟通和交流，子任务与人员之间存在着错综复杂的关系所以软件系统开发中需要编写多种不同类型的文档，每种文档都针对项目中需要进行广泛交流的内容。

软件需求师项目中需要进行广泛交流的内容之一，所以需求开发阶段需要进行需求的文档化~

二.需求文档基础

1.需求文档的交流对象

• 用户：验证文档描述的需求信息是否与其最初的意图一致
• 项目管理者：基于需求文档进行软件估算，并根据估算数据安排项目进度和人员分工
• 设计人员和程序员：判断工作是否正确的一个标准
• 测试人员：测试人员需要根据文档的需求内容进行验收测试，确保最终产生的软件系统能够满足用户的要求~
• 文档编写人员：编写用户使用手册
• 维护人员：在充分理解软件原有需求的基础上进行信息的修改

2.用例文档

用例文档从用户的角度以用例文本为主描述软件系统与外界的交互，以用例的文档描述为主组织需求的文档化，基本职责是把问题域信息和需求传达给软件系统解决方案的设计者，它的书写方法和内容精确度不同于软件规格说明文档~

3.软件需求规格说明文档

描述了软件系统的解决方案，从软件产品的角度以系统级需求列表的方式描述软件系统解决方案~

三.需求文档化要点

1.技术文档协作要点

• 简洁：技术文档域文学作品的最大区别是技术文档必须简洁~
• 精确：内容必须精确~
• 易读：技术文档被使用的主要目的是进行交流与沟通
• 易修改：技术文档通常随着开发工作的持续而被不断修改~

2.需求书写要点

• 使用用户术语
• 可验证
• 可行性

3.软件需求规格说明文档属性要点

• 充分利用标准的文档模板，保持所有内容位置得当
• 保持文档内需求集具有完备性和一致性
• 为需求划分优先级

四.评审软件需求规格说明文档

1.需求验证与确认

文档是项目交流中的最重要内容，众多开发人员都需要以其为基础进行工作；评审是需求验证与确认的主要方法~

2.评审需求的注意事项

• 重视需求评审
• 需求评审的组织

五.以需求为基础开发系统测试用例

包含以下两个步骤

1.开发测试用例套件（以需求为线索）

将相关测的测试用例组织在一起，通常每个测试用例套件是目标明确的一项功能

2.开发测试用例（使用测试技术确定输入输出数据）

设置与场景有关的输入输出~

六.度量需求

重要度量数据：

• 用例的数据
• 平均每个用例中的场景数量
• 平均用例行数
• 软件需求数量
• 非功能需求数量
• 功能点数量

 

七.将需求制品纳入配置管理

• 需求分析模型
• 需求文档
• 系统测试用例