软件文档国家标准重点分析.ppt

第3章 软件文档国家标准 3.1 计算机软件产品开发文档编制指南 3.2 计算机软件需求说明编制指南 3.3 计算机软件测试文档编制规范 3.4 软件文档管理指南 3.0 软件工程标准 软件工程标准可以分为基础标准、开发标准、文档标准以及管理标准4种。 我国已经发布的文档标准： 计算机软件文档编制规范（GB/T 8567-2006） 计算机软件需求规格说明规范（GB/T 9385-2008） 计算机软件测试文档编制规范（GB/T 9386-2008） 软件文档管理指南（GB/T 16680-1996） 3.1 计算机软件文档编制规范 计算机软件文档编制规范（GB/T 8567-2006）是指导性文档。该标准是GB/T8567—1988《计算机软件产品开发文件编制指南》的修订版，并改名为《计算机软件文档编制规范》。并从实施之日起代替GB/T8567—1988。 GB/T 8567-1988由原电子工业部提出，中国软件技术公司负责起草， 国家标准局于1988年1月7日批准，1988年7月1日实施。于新标准实施之日废止。 3.1 计算机软件文档编制规范 3.1.1 软件文档的组成 根据该指南，一个计算机软件的开发过程中，一般应产生14种文档。指南不仅给出了14种文档的编制指导，同时，也是这14种文档编写质量的检验准则。 3.1.2 各类文档的内容要求 14种文档的内容及要求：详见文档 3.2 计算机软件需求规格说明规范 计算机软件需求规格说明规范（GB/T 9385-2008）为软件需求的实践提供了一个规范化的方法。适用于编写软件需求规格说明书，它描述了一个软件需求说明书所必需的内容和质量。 该规范是GB/T9385-1988《计算机软件需求说明编制指南》的第一次修订。 GB/T9385-1988由原电子工业部于1988年4月26日批准，1988年12月1日实施。于新标准实施之日废止。 3.2 计算机软件需求规格说明规范 3.2.1 软件需求文档的编制目标 SRS Software Requirments Specifications 软件需求说明 SRS对于软件顾客来讲，应尽可能准确地描述其所需要的产品；而对于供方来讲，应能准确地理解客户所需要的产品。 其作用可概括以下为6个方面: 3.2 计算机软件需求规格说明规范 1．对于提供什么软件产品，为顾客和供方之间的协议建立基础。 SRS中软件功能的完备描述将协助潜在用户，以便确定指定的软件是否满足其需要，或者为满足其需要应如何定义该软件。 2. 减少开发工作; SRS文档的编制迫使顾客组织有关各方面人员在设计之前严格考虑所有的需求，并减少以后的重新设计、重新编码和重新测试。对SRS中的各项需求进行仔细评审，可以在开发周期的早期揭示某些遗漏、误解和不一致，此时问题更容易纠正。 3.2 计算机软件需求规格说明规范 3．为估计成本和进度提供基础； SRS中给出的待开发产品的描述是估计项目成本的现实基础，可用于取得投标认可或得出价格估算。 4. 为验证和确认提供基线; 通过一份好的SRS文档，组织可提出更加有效的验证和确认计划。作为开发合同的一部分，SRS提供了可用于测量一致性的基线。 3.2 计算机软件需求规格说明规范 5．便于软件产品转移； SRS文档使软件产品转移到新的用户机器更容易，顾客因此发现软件产品更容易转移到组织的其他部门，供方发现软件产品更容易转移到新的顾客。 6. 作为进一步增强的基础; 因为SRS文档讨论的是产品而不是开发他的项目，因此，SRS是已经开发产品后续增强的基础。尽管SRS文档或许需要修改，但他确实为后续产品评价提供了基础。 3.2 计算机软件需求规格说明规范 3.2.2 软件需求文档的基本要求 SRS是对要完成一定功能、性能的软件产品、程序或一组程序的说明。因此对SRS的描述有两项基本要求： 1. 必须描述一定的功能、性能； 2. 必须用确定的方法叙述这些功能。 SRS作为软件开发规范之一，对软件开发的所有阶段都起着非常重要的作用。但是，需要注意的是：SRS不能超出其作用范围，即除了SRS正确地定义所有软件的需求之外，一般地SRS不描述任何设计、验证或项目管理的细节，这是对SRS的另外两个要求。 3.2 计算机软件需求规格说明规范 3.2.3