编写规格说明书
项目视图和范围文档包含了业务需求,而使用实例文档则包含了用户需求。你必须编写从使用实例派生出的功能需求文档,还要编写产品的非功能需求文档,包括质量属性和外部接口需求。软件需求规格说明阐述一个软件系统必须提供的功能和性能以及它所要考虑的限制条件,它不仅是系统测试和用户文档的基础,也是所有子系列项目规划、设计和编码的基础。它应该尽可能完整地描述系统预期的外部行为和用户可视化行为。除了设计和实现上的限制,软件需求规格说明不应该包括设计、构造、测试或工程管理的细节。
1)采用软件需求规格说明模版: 采用需求规格说明书模板在你的组织中要为编写软件需求文档定义一种标准模板。该模板为记录功能需求和各种其它与需求相关的重要信息提供了统一的结构。注意,其目的并非是创建一种全新的模板,而是采用一种已有的且可满足项目需要并适合项目特点的模板。许多组织一开始都采用IEEE标准830-1998(IEEE 1998)描述的需求规格说明书模板。要相信模板是很有用的,但有时要根据项目特点进行适当的改动。
|
1 |
2 |
3 |
4 |
5 |
6 |
A引言 |
目的 |
文档约定 |
预期的读者和阅读建议 |
产品的范围 |
参考文献 |
|
B综合描述 |
产品的前景 |
产品的功能 |
用户类和特征 |
运行环境 |
设计和实现上的限制 |
假设和依赖附录 |
C外部接口需求附录 |
用户界面附录 |
硬件接口 |
软件接口 |
通信接口 |
|
|
D系统特性 |
说明和优先级 |
激励/响应序列 |
功能需求 |
|
|
|
E 其它非功能需求 |
性能需求 |
安全设施需求 |
安全性需求 |
软件质量属性 |
业务规则 |
用户文档 |
F其它需求 |
|
|
|
|
|
|
G附件 |
词汇表 |
分析模型 |
待确定问题的列表 |
|
|
|
表2 需求规格说明模板
a. 引言
引言提出了对软件需求规格说明的纵览,这有助于读者理解文档如何编写并且如何阅读和解释。
a . 1 目的
对产品进行定义,在该文档中详尽说明了这个产品的软件需求,包括修正或发行版本号。如果这个软件需求规格说明只与整个系统的一部分有关系,那么就只定义文档中说明的部分或子系统。
a.2 文档约定
描述编写文档时所采用的标准或排版约定,包括正文风格、提示区或重要符号。
a.3 预期的读者和阅读建议
列举了软件需求规格说明所针对的不同读者,例如开发人员、项目经理、营销人员、用户、测试人员或文档的编写人员。描述了文档中剩余部分的内容及其组织结构。提出了最适合于每一类型读者阅读文档的建议。
a.4 产品的范围
提供了对指定的软件及其目的的简短描述,包括利益和目标。把软件与企业目标或业务策略相联系。可以参考项目视图和范围文档而不是将其内容复制到这里。
a.5 参考文献
列举了编写软件需求规格说明时所参考的资料或其它资源。这可能包括用户界面风格指导、合同、标准、系统需求规格说明、使用实例文档,或相关产品的软件需求规格说明。
b. 综合描述
这一部分概述了正在定义的产品以及它所运行的环境、使用产品的用户和已知的限制、假设和依赖。
b.1 产品的前景
描述了软件需求规格说明中所定义的产品的背景和起源。说明了该产品是否是产品系列中的下一成员,是否是成熟产品所改进的下一代产品、是否是现有应用程序的替代品,或者是否是一个新型的、自含型产品。
b.2 产品的功能
概述了产品所具有的主要功能。其详细内容将在d 中描述,所以在此
项目经理胜任力免费测评PMQ上线啦!快来测测你排多少名吧~
http://www.leadge.com/pmqhd/index.html