软件文档写作02-文档标准

《软件文档写作02-文档标准》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、你思考过吗?软件危机的出路在于软件开发的工程化和标准化。程序设计语言的标准化：为某一程序设计语言规定若干个标准子集，对于语言的实现者和用户都带来了很大方便。软件过程的标准化：软件生存期各个阶段的工作建立标准或规范12第二讲软件工程标准化和软件文档标准32.1软件工程标准化1.什么是“标准”？1983年，我国颁布的国家标准(GB3935.1-83)对“标准”的定义是：“标准是对重复性事物和概念所做的统一规定。它以科学、技术、实践经验和综合成果为基础，经有关方面协商一致，由主管机构批准，以特定形式发布，作为共同

2、遵守的准则和依据”。1983年，国际标准化组织发布的ISO第二号指南(第四版)对“标准”的重新定义是：“由有关各方根据科学技术成就与先进经验，共同合作起草，一致或基本一致同意的技术规范或其它公开文件，其目的在于促进最佳的公众利益，并由标准化团体批准”。2000年发布的GB/T1.1-2000“标准化工作导则”中，将“标准”定义为：“为在一定范围内获得最佳秩序，对活动或其结果规定共同的和重复的规则、导则或特性文件。该文件经协商一致制定并经一个公认机构的批准。标准应以科学、技术和经验的综合成果为基础，以促进最佳

3、社会效益为目的。”简单地说:标准就是完成一项工作必须遵循的统一的模板和技术指标42.软件工程标准化随着计算机科学技术的迅速发展和计算机应用领域的不断扩大，如何高效开发软件产品，提高软件质量，越来越受到人们的重视。同时，软件的规模和复杂度在持续的增加，人们对软件产品开发过程系统化、规范化和标准化的要求也越来越严格。因此，软件工程标准化、软件文档规范化，已经成为软件领域继软件工程学后，影响软件行业发展的又一个重要因素，受到软件企业的高度重视。而所有这些方面建立的标准或规范，即是软件工程标准化。到1999年底，I

4、SO/JTC1已制定出近40项软件工程国际标准。我国自1983年起至今，也已陆续制定、发布了20余项软件工程国家标准。53.软件工程标准化的意义软件企业实施软件工程标准化后的益处，主要表现在以下几个方面：1.提高软件的可靠性、可维护性和可移植性；2.提高软件的生产率和软件人员的技术水平；3.提高软件人员之间的通信效率，减少差错和误解；4.有利于软件管理；5.有利于降低软件产品的成本和运行维护成本；6.有利于缩短软件开发周期。在使用工程化的原理和方法来指导软件的开发和维护时，必须充分注意软件文档的编制和管理。

5、4.软件工程标准化的类型参照其它工程领域对工程标准划分的方法，软件工程标准主要有两种划分方法：按标准的类型划分和按标准的范围划分。6(1)按标准的类型划分主要有过程标准、产品标准、行业标准、记法标准等。过程标准与开发一个产品或从事一项服务的一系列活动或操作有关。过程标准使用一组方法、工具和技术，给出“谁来做”、“做什么”、“如何做”、“何时做”、“何地做”及在软件工程活动中进行的不同层次工作的过程模型。产品标准则涉及软件工程事务的格式和内容，如需求、设计、计划等。软件开发和维护活动文档化的结果就是软件产品，

6、软件文档是软件工程活动进一步开展的基础。软件开发作为一种行业，其行业标准涉及软件工程的所有方面，如执业认证、职业培训、产品许可等。行业标准可以等同于行业行为规范。记法标准规定了在软件工程行业范围内，以唯一的方式进行交流的方法，如术语、表示法、语言等。它其实是一种语境规范。(2)按标准的范围划分主要是根据软件的任务功能和软件生存期进行比较、判定、评价和确定软件工程标准的范围和内容。任务功能可以表示软件工程过程，可以划分为产品工程功能、验证与确认功能以及技术管理功能3个部分。产品工程功能包括定义、生产和支持最终

7、产品所必须的过程。验证和确认功能是检查产品质量的活动。技术管理功能是构造和控制产品工程的过程。这3个部分并不集中在单个的软件生存周期里，而是并行进行的生产、检查和控制活动。标准范围标准类型软件生存期概念需求设计实现测试制造安装与检验运行/维护引退过程方法技术度量产品需求GB/T9385-1988设计部件描述计划报告行业职业道德准则认证特许课程记法术语表示法GB/T1526-1989语言7根据以上两种分类方法，软件工程标准可用一张二维表格来表示。标准范围标准类型过程管理产品管理资源管理评审与审计产品分析测试过

8、程方法GB/T8566-1995技术度量产品需求设计部件描述计划报告行业职业道德准则认证特许课程记法术语表示法语言89上述两表给出了二维表的大致格式。其中，给出了GB/T9385-1988、GB/T1526-1989、GB/T8566-1995这3个标准的例子，用于说明各个标准的类型及其作用。1.GB/T9385-1988是原电子工业部批准的《计算机软件需求说明编制指南》，用于指导软件需求规格说明书的编写。2.G