软件文档写作第2讲文档标准PPT资料.ppt

软件文档写作第2讲文档标准PPT资料.ppt

《软件文档写作第2讲文档标准PPT资料.ppt》由会员分享，可在线阅读，更多相关《软件文档写作第2讲文档标准PPT资料.ppt（31页珍藏版）》请在冰豆网上搜索。

“标准是对重复性事物和概念所做的统一规定。

它以科学、技术、实践经验和综合成果为基础，经有关方面协商一致，由主管机构批准，以特定形式发布，作为共同遵守的准则和依据”。

1983年，国际标准化组织发布的ISO第二号指南（第四版）对“标准”的重新定义是：

“由有关各方根据科学技术成就与先进经验，共同合作起草，一致或基本一致同意的技术规范或其它公开文件，其目的在于促进最佳的公众利益，并由标准化团体批准”。

2000年发布的GB/T1.1-2000“标准化工作导则”中，将“标准”定义为：

“为在一定范围内获得最佳秩序，对活动或其结果规定共同的和重复的规则、导则或特性文件。

该文件经协商一致制定并经一个公认机构的批准。

标准应以科学、技术和经验的综合成果为基础，以促进最佳社会效益为目的。

”简单地说简单地说:

标准就是完成一项工作必须遵循的统一的模板和技术指标标准就是完成一项工作必须遵循的统一的模板和技术指标42.2.软件工程标准化软件工程标准化随随着着计计算算机机科科学学技技术术的的迅迅速速发发展展和和计计算算机机应应用用领领域域的的不不断断扩扩大大，如如何何高高效效开开发发软软件件产产品品，提提高高软软件件质质量量，越越来来越越受受到到人人们们的的重重视视。

同同时时，软软件件的的规规模模和和复复杂杂度度在在持持续续的的增增加加，人人们们对对软软件件产产品品开开发发过过程程系系统统化化、规范化和标准化的要求也越来越严格。

规范化和标准化的要求也越来越严格。

因因此此，软软件件工工程程标标准准化化、软软件件文文档档规规范范化化，已已经经成成为为软软件件领领域域继继软软件件工工程程学学后后，影影响响软软件件行行业业发发展展的的又又一一个个重重要要因因素素，受受到到软软件件企企业业的的高高度重视。

而所有这些方面建立的标准或规范，即是软件工程标准化。

度重视。

到到19991999年年底底，ISO/JTC1ISO/JTC1已已制制定定出出近近4040项项软软件件工工程程国国际际标标准准。

我我国国自自19831983年起至今，也已陆续制定、发布了年起至今，也已陆续制定、发布了2020余项软件工程国家标准。

余项软件工程国家标准。

53.3.软件工程标准化的意义软件工程标准化的意义软件企业实施软件工程标准化后的益处，主要表现在以下几个方面：

软件企业实施软件工程标准化后的益处，主要表现在以下几个方面：

1.1.提高软件的可靠性、可维护性和可移植性；

提高软件的可靠性、可维护性和可移植性；

2.2.提高软件的生产率和软件人员的技术水平；

提高软件的生产率和软件人员的技术水平；

3.3.提高软件人员之间的通信效率，减少差错和误解；

提高软件人员之间的通信效率，减少差错和误解；

4.4.有利于软件管理；

有利于软件管理；

5.5.有利于降低软件产品的成本和运行维护成本；

有利于降低软件产品的成本和运行维护成本；

6.6.有利于缩短软件开发周期。

有利于缩短软件开发周期。

在使用工程化的原理和方法来指导软件的开发和维护时，必须充分注意软件在使用工程化的原理和方法来指导软件的开发和维护时，必须充分注意软件文档的编制和管理。

文档的编制和管理。

4.4.软件工程标准化的类型软件工程标准化的类型参照其它工程领域对工程标准划分的方法，软件工程标准主要有两种划分参照其它工程领域对工程标准划分的方法，软件工程标准主要有两种划分方法：

方法：

按标准的类型划分按标准的类型划分和和按标准的范围划分按标准的范围划分。

6

（1）

（1）按标准的类型划分按标准的类型划分主要有主要有过程标准、产品标准、行业标准、记法标准过程标准、产品标准、行业标准、记法标准等。

等。

过过程程标标准准与与开开发发一一个个产产品品或或从从事事一一项项服服务务的的一一系系列列活活动动或或操操作作有有关关。

过过程程标标准准使使用用一一组组方方法法、工工具具和和技技术术，给给出出“谁谁来来做做”、“做做什什么么”、“如如何何做做”、“何何时时做做”、“何地做何地做”及在软件工程活动中进行的不同层次工作的过程模型。

及在软件工程活动中进行的不同层次工作的过程模型。

产产品品标标准准则则涉涉及及软软件件工工程程事事务务的的格格式式和和内内容容，如如需需求求、设设计计、计计划划等等。

软软件件开开发发和和维护活动维护活动文档化文档化的结果就是软件产品，软件文档是软件工程活动进一步开展的基础。

的结果就是软件产品，软件文档是软件工程活动进一步开展的基础。

软软件件开开发发作作为为一一种种行行业业，其其行行业业标标准准涉涉及及软软件件工工程程的的所所有有方方面面，如如执执业业认认证证、职职业业培训、产品许可等。

行业标准可以等同于行业行为规范。

培训、产品许可等。

记记法法标标准准规规定定了了在在软软件件工工程程行行业业范范围围内内，以以唯唯一一的的方方式式进进行行交交流流的的方方法法，如如术术语语、表示法、语言等。

它其实是一种语境规范。

表示法、语言等。

（2）

（2）按标准的范围划分按标准的范围划分主主要要是是根根据据软软件件的的任任务务功功能能和和软软件件生生存存期期进进行行比比较较、判判定定、评评价价和和确确定定软软件件工工程程标标准准的的范范围围和和内内容容。

任任务务功功能能可可以以表表示示软软件件工工程程过过程程，可可以以划划分分为为产产品品工工程程功功能能、验验证证与确认功能以及技术管理功能与确认功能以及技术管理功能33个部分。

个部分。

产产品品工工程程功功能能包包括括定定义义、生生产产和和支支持持最最终终产产品品所所必必须须的的过过程程。

验验证证和和确确认认功功能能是是检检查产品质量的活动。

查产品质量的活动。

技术管理功能技术管理功能是构造和控制产品工程的过程。

是构造和控制产品工程的过程。

这这33个个部部分分并并不不集集中中在在单单个个的的软软件件生生存存周周期期里里，而而是是并并行行进进行行的的生生产产、检检查查和和控控制制活活动。

动。

标准范围标准范围标准类型标准类型软软件件生生存存期期概念概念需求需求设计设计实现实现测试测试制造制造安装与安装与检验检验运行运行/维护维护引退引退过过程程方法方法技术技术度量度量产产品品需求需求GB/T9385-1988设计设计部件部件描述描述计划计划报告报告行行业业职业职业道德准则道德准则认证认证特许特许课程课程记记法法术语术语表示法表示法GB/T1526-1989语言语言7根据以上两种分类方法，软件工程标准可用一张二维表格来表示。

根据以上两种分类方法，软件工程标准可用一张二维表格来表示。

标准范围标准范围标准类型标准类型过程管理过程管理产品管理产品管理资源管理资源管理评审与审计评审与审计产品分析产品分析测试测试过过程程方法方法GB/T8566-1995技术技术度量度量产产品品需求需求设计设计部件部件描述描述计划计划报告报告行行业业职业职业道德准则道德准则认证认证特许特许课程课程记记法法术语术语表示法表示法语言语言89上上述述两两表表给给出出了了二二维维表表的的大大致致格格式式。

其其中中，给给出出了了GB/TGB/T9385-9385-19881988、GB/TGB/T1526-19891526-1989、GB/TGB/T8566-19958566-1995这这33个个标标准准的的例例子子，用用于于说说明各个标准的类型及其作用。

明各个标准的类型及其作用。

1.1.GB/TGB/T9385-19889385-1988是是原原电电子子工工业业部部批批准准的的计计算算机机软软件件需需求求说说明编制指南明编制指南，用于指导软件需求规格说明书的编写。

，用于指导软件需求规格说明书的编写。

2.2.GB/TGB/T1526-19891526-1989是是国国家家标标准准总总局局批批准准的的信信息息处处理理数数据据流流图图、程程序序流流程程图图、系系统统结结构构图图、程程序序网网络络图图、系系统统资资源源图图的的文文件件编编制制符号及约定。

符号及约定。

3.3.GB/TGB/T8566-19958566-1995是是国国家家标标准准总总局局批批准准的的信信息息技技术术软软件件生生存存期期过过程程标标准准，它它规规定定了了在在获获取取、供供应应、开开发发、操操作作、维维护护软软件件时时，要要实实施施的的过过程程、活活动动和和任任务务。

目目的的是是为为用用户户提提供供一一个个公公共共的的框框架架，使使软件从业人员可以使用软件从业人员可以使用“相同的语言相同的语言”创作和管理软件。

创作和管理软件。

从从表表中中可可以以看看到到软软件件工工程程标标准准的的范范围围和和标标准准如如何何分分类类，因因此此对对相相关关标标准准的的编编制制、开开发发具具有有指指导导作作用用，而而已已经经制制定定的的标标准准也也都都可可以以在在表表中找到相应的位置。

所以，该表还可以启发制定新的标准。

中找到相应的位置。

102.22.2软件工程标准编制的层次软件工程标准编制的层次根根据据软软件件工工程程标标准准制制定定的的机机构构和和标标准准适适用用的的范范围围，可可分分为为55个个层层次次：

国国际标准、国家标准、行业标准、企业际标准、国家标准、行业标准、企业（机构机构）标准、项目标准、项目（课题课题）标准。

标准。

1.1.国际标准国际标准：

由国际联合机构制定和公布的标准，供各国参考。

：

如如ISOISO国际标准化组织。

国际标准化组织。

2.2.国家标准国家标准：

由政府或国家级的机构制定或批准，适用于全国范围。

如如GBGB中中国国国国标标、ANSI_ANSI_美美国国国国家家标标准准协协会会、BSBS英英国国国国家家标标准准、JISJIS日本工业标准。

日本工业标准。

3.3.行行业业标标准准：

由由行行业业机机构构、学学术术团团体体或或国国防防等等机机构构制制定定，适适用用于于某某个个业业务务领域。

领域。

如如IEEEIEEE美国电气和电子工程师学会、美国电气和电子工程师学会、GJBGJB中国国家军用标准。

中国国家军用标准。

4.4.企业规范企业规范：

企业因软件工程工作的需要制定的适用于本企业的规范。

如如IBMIBM通用产品部于通用产品部于19841984年制定的年制定的程序设计开发指南程序设计开发指南。

5.5.项项目目规规范范：

由由某某一一科科研研生生产产项项目目组组织织制制定定，仅仅为为该该项项目目任任务务服服务务的的软软件件工程规范。

工程规范。

如如CIMSCIMS计算机集成制造系统计算机集成制造系统软件工程规范。

软件工程规范。

112.32.3中国的软件标准中国的软件标准19831983年起，我国陆续制定和发布了年起，我国陆续制定和发布了2020余项软件工程国家标准。

这些标准可以分为以下四类：

1.1.基础标准基础标准：

规定了信息加工处理和软件工程领域的术语、符：

规定了信息加工处理和软件工程领域的术语、符号、表示、构造、分类级约定；

号、表示、构造、分类级约定；

2.2.开发标准开