《软件文档国家标准》由会员分享,可在线阅读,更多相关《软件文档国家标准(37页珍藏版)》请在金锄头文库上搜索。
1、郑州大学信息工程学院 徐婷软件文档1-1第第3章章 软件文档国家标准软件文档国家标准 3.1 3.1 计算机软件产品开发文档编制指南计算机软件产品开发文档编制指南3.2 3.2 计算机软件需求说明编制指南计算机软件需求说明编制指南 3.3 3.3 计算机软件测试文档编制规范计算机软件测试文档编制规范 3.4 3.4 软件文档管理指南软件文档管理指南 郑州大学信息工程学院 徐婷软件文档1-23.0 软件工程标准软件工程标准 软件工程标准可以分为软件工程标准可以分为基础标准基础标准、开发标准开发标准、文档标准文档标准以及以及管理标准管理标准4种。种。 我国已经发布的文档标准:我国已经发布的文档标准
2、:计算机软件文档编制规范(计算机软件文档编制规范(GB/T 8567-2006GB/T 8567-2006)计算机软件需求规格说明规范(计算机软件需求规格说明规范(GB/T 9385-2008GB/T 9385-2008)计算机软件测试文档编制规范(计算机软件测试文档编制规范(GB/T 9386-2008GB/T 9386-2008)软件文档管理指南(软件文档管理指南(GB/T 16680-1996GB/T 16680-1996)郑州大学信息工程学院 徐婷软件文档1-33.1 计算机软件文档编制规范计算机软件文档编制规范 计算机软件文档编制规范计算机软件文档编制规范(GB/T 8567-200
3、6)是是指导性文档指导性文档。该标准是。该标准是GB/T85671988计算机软计算机软件产品开发文件编制指南件产品开发文件编制指南的修订版,并改名为的修订版,并改名为计计算机软件文档编制规范算机软件文档编制规范。并从实施之日起代替。并从实施之日起代替GB/T85671988。 GB/T 8567-1988由原电子工业部提出,中国软件由原电子工业部提出,中国软件技术公司负责起草,技术公司负责起草, 国家标准局于国家标准局于1988年年1月月7日批准,日批准,1988年年7月月1日实施。日实施。于新标准实施之日废止。于新标准实施之日废止。郑州大学信息工程学院 徐婷软件文档1-43.1.1 软件文
4、档的组成软件文档的组成 根据该指南,一个计算机软件的开发过程中,一根据该指南,一个计算机软件的开发过程中,一般应产生般应产生14种文档。指南不仅给出了种文档。指南不仅给出了14种文档的编制种文档的编制指导,同时,也是这指导,同时,也是这14种文档编写质量的检验准则。种文档编写质量的检验准则。3.1.2 各类文档的内容要求各类文档的内容要求 14种文档的内容及要求种文档的内容及要求:详见文档详见文档3.1 计算机软件文档编制规范计算机软件文档编制规范郑州大学信息工程学院 徐婷软件文档1-53.2 计算机软件需求规格说明规范计算机软件需求规格说明规范 计算机软件需求规格说明规范计算机软件需求规格说
5、明规范(GB/T 9385-2008)为软件需求的实践提供了一个规范化的方法。适用于编为软件需求的实践提供了一个规范化的方法。适用于编写软件需求规格说明书,它描述了一个软件需求说明书写软件需求规格说明书,它描述了一个软件需求说明书所必需的内容和质量。所必需的内容和质量。 该规范是该规范是GB/T9385-1988计算机软件需求说明编制计算机软件需求说明编制指南的第一次修订。指南的第一次修订。 GB/T9385-1988由原电子工业部由原电子工业部于于1988年年4月月26日批准,日批准,1988年年12月月1日实施。日实施。于新标准于新标准实施之日废止。实施之日废止。郑州大学信息工程学院 徐婷
6、软件文档1-63.2.1 软件需求文档的编制目标软件需求文档的编制目标 SRS Software Requirments Specifications 软件需求说明软件需求说明 SRS对于软件对于软件顾客顾客来讲,应尽可能准确地描述其所需来讲,应尽可能准确地描述其所需要的产品;而对于要的产品;而对于供方来讲供方来讲,应能准确地理解客户所需,应能准确地理解客户所需要的产品。要的产品。 其作用可概括以下为其作用可概括以下为6个方面个方面:3.2 计算机软件需求规格说明规范计算机软件需求规格说明规范郑州大学信息工程学院 徐婷软件文档1-71对于提供什么软件产品,为顾客和供方之间的协对于提供什么软件产
7、品,为顾客和供方之间的协议建立基础。议建立基础。 SRS中软件功能的完备描述将协助潜在用户,中软件功能的完备描述将协助潜在用户,以便确定指定的软件是否满足其需要,或者为满足以便确定指定的软件是否满足其需要,或者为满足其需要应如何定义该软件。其需要应如何定义该软件。2. 减少开发工作减少开发工作; SRS文档的编制迫使顾客组织有关各方面人员文档的编制迫使顾客组织有关各方面人员在设计之前严格考虑所有的需求,并减少以后的重在设计之前严格考虑所有的需求,并减少以后的重新设计、重新编码和重新测试。对新设计、重新编码和重新测试。对SRS中的各项需中的各项需求进行仔细评审,可以在开发周期的早期揭示某些求进行
8、仔细评审,可以在开发周期的早期揭示某些遗漏、误解和不一致,此时问题更容易纠正。遗漏、误解和不一致,此时问题更容易纠正。3.2 计算机软件需求规格说明规范计算机软件需求规格说明规范郑州大学信息工程学院 徐婷软件文档1-83为估计成本和进度提供基础;为估计成本和进度提供基础; SRS中给出的待开发产品的描述是估计项目成中给出的待开发产品的描述是估计项目成本的现实基础,可用于取得投标认可或得出价格估本的现实基础,可用于取得投标认可或得出价格估算。算。4. 为验证和确认提供基线为验证和确认提供基线; 通过一份好的通过一份好的SRS文档,组织可提出更加有效文档,组织可提出更加有效的验证和确认计划。作为开
9、发合同的一部分,的验证和确认计划。作为开发合同的一部分,SRS提供了可用于测量一致性的基线。提供了可用于测量一致性的基线。3.2 计算机软件需求规格说明规范计算机软件需求规格说明规范郑州大学信息工程学院 徐婷软件文档1-95便于软件产品转移;便于软件产品转移; SRS文档使软件产品转移到新的用户机器更容文档使软件产品转移到新的用户机器更容易,顾客因此发现软件产品更容易转移到组织的其易,顾客因此发现软件产品更容易转移到组织的其他部门,供方发现软件产品更容易转移到新的顾客。他部门,供方发现软件产品更容易转移到新的顾客。6. 作为进一步增强的基础作为进一步增强的基础; 因为因为SRS文档讨论的是产品
10、而不是开发他的项文档讨论的是产品而不是开发他的项目,因此,目,因此,SRS是已经开发产品后续增强的基础。是已经开发产品后续增强的基础。尽管尽管SRS文档或许需要修改,但他确实为后续产品文档或许需要修改,但他确实为后续产品评价提供了基础。评价提供了基础。3.2 计算机软件需求规格说明规范计算机软件需求规格说明规范郑州大学信息工程学院 徐婷软件文档1-103.2.2 软件需求文档的基本要求软件需求文档的基本要求 SRS是对要完成一定功能、性能的软件产品、程是对要完成一定功能、性能的软件产品、程序或一组程序的说明。因此对序或一组程序的说明。因此对SRS的描述有两项基本的描述有两项基本要求:要求: 1
11、. 必须描述一定的功能、性能;必须描述一定的功能、性能; 2. 必须用确定的方法叙述这些功能。必须用确定的方法叙述这些功能。 SRS作为作为软件开发规范软件开发规范之一,对软件开发的所有之一,对软件开发的所有阶段都起着非常重要的作用。但是,需要注意的是:阶段都起着非常重要的作用。但是,需要注意的是:SRS不能超出其作用范围不能超出其作用范围,即除了,即除了SRS正确地定义所正确地定义所有软件的需求之外,一般地有软件的需求之外,一般地SRS不描述任何设计、验不描述任何设计、验证或项目管理的细节,这是对证或项目管理的细节,这是对SRS的另外两个要求。的另外两个要求。3.2 计算机软件需求规格说明规
12、范计算机软件需求规格说明规范郑州大学信息工程学院 徐婷软件文档1-113.2.3 软件需求标准适用范围软件需求标准适用范围1.适用对象:适用对象: (1)软件客户,以便精确地描述他们想获得什么)软件客户,以便精确地描述他们想获得什么样的产品;样的产品; (2)软件供方,以便准确地理解客户需要什么样)软件供方,以便准确地理解客户需要什么样的产品。的产品。2.目的:目的: (1)要提出开发规范化的)要提出开发规范化的SRS提纲;提纲; (2)定义自己需要的具体的格式和内容;)定义自己需要的具体的格式和内容; (3)产生附加的局部条款。)产生附加的局部条款。3.2 计算机软件需求规格说明规范计算机软
13、件需求规格说明规范郑州大学信息工程学院 徐婷软件文档1-123.指南引用标准:指南引用标准: (1)GB/T 8566-2007信息技术信息技术软件生存周期过程软件生存周期过程 (2)GB/T 11457-2006信息技术信息技术软件工程术语。软件工程术语。4.有关定义:有关定义: (1)合同:是顾客和供方共同签署的具体有法律约)合同:是顾客和供方共同签署的具体有法律约束力的文件。其中包括产品的技术、组织、成本和进束力的文件。其中包括产品的技术、组织、成本和进度计划要求等内容。度计划要求等内容。3.2 计算机软件需求规格说明规范计算机软件需求规格说明规范郑州大学信息工程学院 徐婷软件文档1-1
14、3 (2)顾客:为产品支付费用,并通常(但不必要)顾客:为产品支付费用,并通常(但不必要)确定需求的个人或群体,在某些情况下,顾客和供方确定需求的个人或群体,在某些情况下,顾客和供方可以是同一组织的成员。可以是同一组织的成员。 (3)供方:为顾客开发产品的个人或群体。在某)供方:为顾客开发产品的个人或群体。在某些情况下,顾客和供方可以是同一组织的成员。些情况下,顾客和供方可以是同一组织的成员。 (4)用户:直接运行系统产品或与产品进行交互)用户:直接运行系统产品或与产品进行交互作用的个人或集团。用户和顾客通常不是同一个人或作用的个人或集团。用户和顾客通常不是同一个人或群体。群体。3.2 计算机
15、软件需求规格说明规范计算机软件需求规格说明规范郑州大学信息工程学院 徐婷软件文档1-143.2.4 需求文档的编写大纲需求文档的编写大纲提纲模板提纲模板按照按照运行模式运行模式组织的组织的SRS具体需求模板具体需求模板1、2按照按照用户类别用户类别组织的组织的SRS具体需求模板具体需求模板按照按照对象对象组织的组织的SRS具体需求模板具体需求模板按照按照系统特征系统特征组织的组织的SRS具体需求模板具体需求模板按照按照激励激励组织的组织的SRS具体需求模板具体需求模板按照按照功能功能层次层次组织的组织的SRS具体需求模板具体需求模板体现多种组织形式体现多种组织形式的的SRS具体需求模板具体需求
16、模板3.2.5 需求文档的编制说明需求文档的编制说明3.2 计算机软件需求规格说明规范计算机软件需求规格说明规范郑州大学信息工程学院 徐婷软件文档1-153.3 计算机软件计算机软件测试测试文档编制规范文档编制规范 测试测试是软件生存周期中一个是软件生存周期中一个独立的独立的、关键的关键的阶段,阶段,也是保证软件质量的重要手段。为了提高检测出错的也是保证软件质量的重要手段。为了提高检测出错的几率,使测试能有计划、有条不紊地进行,就必须编几率,使测试能有计划、有条不紊地进行,就必须编制测试文档。而标准化测试文档就如同一种制测试文档。而标准化测试文档就如同一种通用的参通用的参照体系照体系,可达到便
17、于交流的目的。,可达到便于交流的目的。 计算机软件测试文档编制规范(计算机软件测试文档编制规范(GB/T 9386-GB/T 9386-20082008)的目的就是)的目的就是规定一组软件测试文档规定一组软件测试文档,定义每一定义每一种基本文档的目的、格式和内容种基本文档的目的、格式和内容。测试文档中所规定。测试文档中所规定的内容可以作为对测试过程完备性的对照检查表,这的内容可以作为对测试过程完备性的对照检查表,这将会提高测试过程的每个阶段的能见度,极大地提高将会提高测试过程的每个阶段的能见度,极大地提高测试工作的可管理性。测试工作的可管理性。郑州大学信息工程学院 徐婷软件文档1-163.3
18、计算机软件计算机软件测试测试文档编制规范文档编制规范 该规范替代了该规范替代了GB/T9386-1988GB/T9386-1988计算机软件测试计算机软件测试文档编制规范。文档编制规范。原标准原标准由上海计算机技术开发中心由上海计算机技术开发中心负责起草,负责起草,由原电子工业部于由原电子工业部于19881988年年4 4月月2626日批准,日批准,19881988年年1212月月1 1日实施,日实施,于新标准实施之日废止。于新标准实施之日废止。郑州大学信息工程学院 徐婷软件文档1-173.3.1 标准的适用对象及范围标准的适用对象及范围 该规范是为该规范是为软件管理人员软件管理人员、软件开发
19、软件开发、测试和维测试和维护人员护人员、软件质量保证人员软件质量保证人员、审计人员审计人员、客户客户及及用户用户制定的。制定的。 用于描述一组用于描述一组与软件测试实施方面有关与软件测试实施方面有关的基本测的基本测试文档,该标准定义每一种基本文档的目的、格式和试文档,该标准定义每一种基本文档的目的、格式和内容。尽管标准所描述的文档内容。尽管标准所描述的文档侧重于动态测试活动侧重于动态测试活动,但是有些文档仍适用于其他种类的测试活动(例如:但是有些文档仍适用于其他种类的测试活动(例如:测试计划可用于设计和代码评审)。测试计划可用于设计和代码评审)。3.3 计算机软件计算机软件测试测试文档编制规范
20、文档编制规范郑州大学信息工程学院 徐婷软件文档1-183.3.1 标准的适用对象及范围标准的适用对象及范围 该标准可应用于该标准可应用于数字计算机上运行的商用软件、数字计算机上运行的商用软件、科学计算软件或者军用软件科学计算软件或者军用软件。它的应用范围不受软件。它的应用范围不受软件大小、复杂度或关键性的限制。本规范既适用于大小、复杂度或关键性的限制。本规范既适用于初始初始开发的软件测试文件开发的软件测试文件编制,也适用于编制,也适用于其后的软件产品其后的软件产品更新版本的测试文档更新版本的测试文档编制。编制。 并不要求采用特定的测试方法学、技术、设备或并不要求采用特定的测试方法学、技术、设备
21、或工具工具。对文件控制、配置管理或质量保证既不指明也对文件控制、配置管理或质量保证既不指明也不强制特定的方法学不强制特定的方法学。根据所用的方法学,可能需要根据所用的方法学,可能需要增加增加一些其他文档一些其他文档(如(如“质量保证计划质量保证计划”)。)。3.3 计算机软件计算机软件测试测试文档编制规范文档编制规范郑州大学信息工程学院 徐婷软件文档1-193.3.2 测试文档的内容测试文档的内容 本规范主要定义了本规范主要定义了3种类型软件测试文档:测试计种类型软件测试文档:测试计划、测试说明和测试报告。划、测试说明和测试报告。1.测试计划测试计划 测试计划描述测试活动的范围、方法、资源和进
22、测试计划描述测试活动的范围、方法、资源和进度。它规定被测试的项、被测试的特性、应完成的测度。它规定被测试的项、被测试的特性、应完成的测试任务、负责每项工作的人员以及与本计划有关的风试任务、负责每项工作的人员以及与本计划有关的风险等。险等。3.3 计算机软件计算机软件测试测试文档编制规范文档编制规范郑州大学信息工程学院 徐婷软件文档1-202.测试说明测试说明包括包括3个文档:个文档: (1)测试设计说明)测试设计说明 详细描述详细描述测试方法测试方法,规定该设计及有关测试所包,规定该设计及有关测试所包括的括的特性特性,还规定完成测试所需要的,还规定完成测试所需要的测试用例测试用例和和测试测试规
23、程规程,并规定,并规定特性的通过准则特性的通过准则。 (2)测试用例说明)测试用例说明 列出用于输入的具体值以及预期的输出结果,并列出用于输入的具体值以及预期的输出结果,并规定在使用具体测试用例时对测试规程的各种限制。规定在使用具体测试用例时对测试规程的各种限制。将测试用例和测试设计分开,可以使它们用于多个设将测试用例和测试设计分开,可以使它们用于多个设计并能在其他情形下重复使用。计并能在其他情形下重复使用。3.3 计算机软件计算机软件测试测试文档编制规范文档编制规范郑州大学信息工程学院 徐婷软件文档1-212.测试说明测试说明 (3)测试规程说明)测试规程说明 详细说明执行一组测试用例的各个
24、步骤,或者详细说明执行一组测试用例的各个步骤,或者更广泛的说明为了评估一组特征而用于分析软件项的更广泛的说明为了评估一组特征而用于分析软件项的各个步骤。各个步骤。测试规程是与设计分开的,主要明确要遵循的测试规程是与设计分开的,主要明确要遵循的步骤,而不宜含有无关的细节。步骤,而不宜含有无关的细节。3.3 计算机软件计算机软件测试测试文档编制规范文档编制规范郑州大学信息工程学院 徐婷软件文档1-223.测试报告测试报告 测试报告包括测试报告包括4个文档:个文档: (1)测试项传递报告)测试项传递报告 指明在开发组和测试组独立工作的情况下或在希指明在开发组和测试组独立工作的情况下或在希望正式开始测
25、试的情况下为进行测试而被传递的测试望正式开始测试的情况下为进行测试而被传递的测试项。项。 (2)测试日志)测试日志 测试组用于记录测试执行过程中发生的情况。测试组用于记录测试执行过程中发生的情况。3.3 计算机软件计算机软件测试测试文档编制规范文档编制规范郑州大学信息工程学院 徐婷软件文档1-23 (3)测试事件报告)测试事件报告 描述在测试执行期间发生并需要进一步调查的一描述在测试执行期间发生并需要进一步调查的一切事件。切事件。 (4)测试总结报告)测试总结报告 总结与测试设计说明有关的测试活动。总结与测试设计说明有关的测试活动。3.3 计算机软件计算机软件测试测试文档编制规范文档编制规范郑
26、州大学信息工程学院 徐婷软件文档1-243.3.3 测试文档与测试过程测试文档与测试过程 描述测试文档与其他文档在编制方面的关系以及描述测试文档与其他文档在编制方面的关系以及同测试过程的对应关系。同测试过程的对应关系。 测试文件与测试过程的关系测试文件与测试过程的关系,如下图所示如下图所示。3.3 计算机软件计算机软件测试测试文档编制规范文档编制规范郑州大学信息工程学院 徐婷软件文档1-25测试文件与测试文件与测试过程的测试过程的关系关系郑州大学信息工程学院 徐婷软件文档1-263.3.4 测试文档的结构测试文档的结构共共8个文档:个文档:1.测试计划测试计划2.测试设计说明测试设计说明3.测
27、试用例说明测试用例说明4.测试规程说明测试规程说明5.测试项传递报告测试项传递报告6.测试日志测试日志7.测试事件报告测试事件报告8.测试总结报告测试总结报告3.3 计算机软件计算机软件测试测试文档编制规范文档编制规范郑州大学信息工程学院 徐婷软件文档1-273.3.5 测试文档的编制测试文档的编制 软件测试软件测试文档的内容主要包括测试计划、测试文档的内容主要包括测试计划、测试设计说明书、测试用例说明、测试规程说明、测试项设计说明书、测试用例说明、测试规程说明、测试项传递报告、测试日志、测试事件报告以及测试总结报传递报告、测试日志、测试事件报告以及测试总结报告告8项项内容。内容。需要需要强调
28、的是,软件测试包括对需求说明书的强调的是,软件测试包括对需求说明书的测试。因此在软件的需求分析阶段就应开始测试文档测试。因此在软件的需求分析阶段就应开始测试文档的编制工作,各种测试文档的编写应按一定的格式进的编制工作,各种测试文档的编写应按一定的格式进行。行。3.3 计算机软件计算机软件测试测试文档编制规范文档编制规范郑州大学信息工程学院 徐婷软件文档1-283.3.5 测试文档的编制测试文档的编制 1.设计测试用例设计测试用例 测试用例(测试用例(test case)是指对一项特定的软件产)是指对一项特定的软件产品进行测试任务的描述,体现测试方案、方法、技术品进行测试任务的描述,体现测试方案
29、、方法、技术和策略。内容包括测试目标、测试环境、输入数据、和策略。内容包括测试目标、测试环境、输入数据、测试步骤、预期结果、测试脚本等,并形成文档。测试步骤、预期结果、测试脚本等,并形成文档。 不同类型软件,测试用例不同。需要针对软件不同类型软件,测试用例不同。需要针对软件产品的功能、业务规则和业务处理,分别对各个开发产品的功能、业务规则和业务处理,分别对各个开发阶段的软件产品设计测试用例。可以减少人为因素的阶段的软件产品设计测试用例。可以减少人为因素的影响。影响。3.3 计算机软件计算机软件测试测试文档编制规范文档编制规范郑州大学信息工程学院 徐婷软件文档1-293.3.5 测试文档的编制测
30、试文档的编制 2.编写测试文档编写测试文档 测试文档主要由若干测试用例组成测试文档主要由若干测试用例组成.各种测试文各种测试文档的编写应按照文档模板,按一定的格式进行,编写档的编写应按照文档模板,按一定的格式进行,编写时可参考时可参考计算机软件文档编制规范计算机软件文档编制规范。 测试文档由简介和测试用例两部分组成。测试文档由简介和测试用例两部分组成。3.3 计算机软件计算机软件测试测试文档编制规范文档编制规范郑州大学信息工程学院 徐婷软件文档1-303.3.6 测试文档的编制实例测试文档的编制实例在实施测试文件编制的初级阶段可先编写测试计划与在实施测试文件编制的初级阶段可先编写测试计划与测试
31、报告文件测试报告文件。 测试计划将为整个测试过程提供基础。测试报告将鼓测试计划将为整个测试过程提供基础。测试报告将鼓励测试单位以良好的方式记录整个测试过程的情况。励测试单位以良好的方式记录整个测试过程的情况。经过一段时间的实践,积累了一定经验后再逐步引进经过一段时间的实践,积累了一定经验后再逐步引进其他文件。其他文件。 测试文件编制最终将形成一个相应于设计层的文件层测试文件编制最终将形成一个相应于设计层的文件层次,即系统测试文件、子系统测试文件及模块测试文件等。次,即系统测试文件、子系统测试文件及模块测试文件等。在本单位所使用的特定的测试技术的文件编制可作为正文在本单位所使用的特定的测试技术的
32、文件编制可作为正文中所述的基本文件集的补充。中所述的基本文件集的补充。3.3 计算机软件计算机软件测试测试文档编制规范文档编制规范郑州大学信息工程学院 徐婷软件文档1-313.3.6 测试文档的编制实例测试文档的编制实例在项目计划及单位标准中,应该指明在哪些测试报告在项目计划及单位标准中,应该指明在哪些测试报告中需要哪些测试文件,并可在文件中加入一些内容,中需要哪些测试文件,并可在文件中加入一些内容,使各个文件适应一个特定的测试项及一个特定的测试使各个文件适应一个特定的测试项及一个特定的测试环境。环境。一个测试文件编制实例一个测试文件编制实例3.3 计算机软件计算机软件测试测试文档编制规范文档
33、编制规范郑州大学信息工程学院 徐婷软件文档1-32文件文件活活动测试计划划测试设计说明明测试用用例例说明明测试规程程说明明测试项传递报告告测试日志日志测试事件事件报告告测试总结报告告验收收安装安装系系统子系子系统模模块郑州大学信息工程学院 徐婷软件文档1-33 软件文档管理指南软件文档管理指南(GB/T 16680-1996) 是是为那些对软件为那些对软件或基于软件或基于软件的产品的开发负有的产品的开发负有职责的职责的管理者提供软件文档的管理者提供软件文档的管理指南。其目的管理指南。其目的在于协助管理者在他们的机构中产生有效的文档在于协助管理者在他们的机构中产生有效的文档。3.4 软件软件文档
34、管理指南文档管理指南郑州大学信息工程学院 徐婷软件文档1-343.4.1 软件文档管理概述软件文档管理概述 软件文档管理涉及策略、标准、规程、资源和计软件文档管理涉及策略、标准、规程、资源和计划,管理者必须关注这些内容,以便有效地管理软件划,管理者必须关注这些内容,以便有效地管理软件文档。文档。 软件文档管理期望应用于各种类型软件,简单软件文档管理期望应用于各种类型软件,简单复杂,并期望覆盖各种类型的软件文档,作用于软件复杂,并期望覆盖各种类型的软件文档,作用于软件生存期的各个阶段。生存期的各个阶段。 不论项目大小,软件文档管理的原则是一致的。不论项目大小,软件文档管理的原则是一致的。 软件文
35、档管理是针对文档编制管理而提出的,不软件文档管理是针对文档编制管理而提出的,不涉及软件文档的内容和编排。涉及软件文档的内容和编排。3.4 软件软件文档管理指南文档管理指南郑州大学信息工程学院 徐婷软件文档1-353.4.2 软件文档与文档管理者软件文档与文档管理者 管理者应严格要求软件开发人员和编制组完成文管理者应严格要求软件开发人员和编制组完成文档编制,并且在策略、标准、规程、资源分配和编制档编制,并且在策略、标准、规程、资源分配和编制计划方面给予支持。主要作用包括三个方面:计划方面给予支持。主要作用包括三个方面: 1.1.管理者对文档工作的责任管理者对文档工作的责任 管理者要认识到正式或非
36、正式文档都是重要的,还要认识管理者要认识到正式或非正式文档都是重要的,还要认识到文档工作必须包括文档计划、编写、修改、形成、分发和维到文档工作必须包括文档计划、编写、修改、形成、分发和维护等各个方面。护等各个方面。 2.2.管理者对文档工作的支持管理者对文档工作的支持 管理者应为编写文档的人员提供指导和实际鼓励,并使各管理者应为编写文档的人员提供指导和实际鼓励,并使各种资源有效地用于文档开发。种资源有效地用于文档开发。3.4 软件软件文档管理指南文档管理指南郑州大学信息工程学院 徐婷软件文档1-363.4.2 软件文档与文档管理者软件文档与文档管理者3.3.管理者的主要职责管理者的主要职责(1
37、 1)承担的职责)承担的职责建立编制、登记、出版系统文档和软件文档的各种策略;建立编制、登记、出版系统文档和软件文档的各种策略;把文档计划作为整个开发工作的一个组成部分;把文档计划作为整个开发工作的一个组成部分;建立确定文档质量、测试质量和评审质量的各种方法的规程;建立确定文档质量、测试质量和评审质量的各种方法的规程;为文档的各个方面确定和准备各种标准和指南;为文档的各个方面确定和准备各种标准和指南;积极支持文档工作以形成在开发工作中自觉编制文档的团队风积极支持文档工作以形成在开发工作中自觉编制文档的团队风气;气;不断检查已建立起来的过程,以保证符合策略和各种规程并遵不断检查已建立起来的过程,
38、以保证符合策略和各种规程并遵守有关标准和指南。守有关标准和指南。3.4 软件软件文档管理指南文档管理指南郑州大学信息工程学院 徐婷软件文档1-373.4.2 软件文档与文档管理者软件文档与文档管理者3.管理者的主要职责管理者的主要职责(2 2)项目开发前的工作)项目开发前的工作要求哪些类型的文档;要求哪些类型的文档;提供多少种文档;提供多少种文档;文档包含的内容;文档包含的内容;达到何种级别的质量水平;达到何种级别的质量水平;何时产生何种文档;何时产生何种文档;如何保存、维护文档以及如何进行通信。如何保存、维护文档以及如何进行通信。 若一个软件合同是有效的,应要求文档满足所接受的标若一个软件合同是有效的,应要求文档满足所接受的标准,并规定所提供的文档类型、每种文档的质量水平以及评审准,并规定所提供的文档类型、每种文档的质量水平以及评审和通过的规程。和通过的规程。3.4 软件软件文档管理指南文档管理指南