软件文档写作02-文档标准创新.pptVIP

你思考过吗? 软件危机的出路在于软件开发的工程化和标准化。 程序设计语言的标准化：为某一程序设计语言规定若干个标准子集，对于语言的实现者和用户都带来了很大方便。 软件过程的标准化：软件生存期各个阶段的工作建立标准或规范 * * 第二讲 软件工程标准化 和软件文档标准 * 2.1 软件工程标准化 1. 什么是“标准”？ 1983年，我国颁布的国家标准(GB3935.1-83)对“标准”的定义是：“标准是对重复性事物和概念所做的统一规定。它以科学、技术、实践经验和综合成果为基础，经有关方面协商一致，由主管机构批准，以特定形式发布，作为共同遵守的准则和依据”。 1983年，国际标准化组织发布的ISO第二号指南(第四版)对“标准”的重新定义是：“由有关各方根据科学技术成就与先进经验，共同合作起草，一致或基本一致同意的技术规范或其它公开文件，其目的在于促进最佳的公众利益，并由标准化团体批准”。 2000年发布的GB/T1.1-2000“标准化工作导则”中，将“标准”定义为：“为在一定范围内获得最佳秩序，对活动或其结果规定共同的和重复的规则、导则或特性文件。该文件经协商一致制定并经一个公认机构的批准。标准应以科学、技术和经验的综合成果为基础，以促进最佳社会效益为目的。” 简单地说:标准就是完成一项工作必须遵循的统一的模板和技术指标 * 2. 软件工程标准化 随着计算机科学技术的迅速发展和计算机应用领域的不断扩大，如何高效开发软件产品，提高软件质量，越来越受到人们的重视。同时，软件的规模和复杂度在持续的增加，人们对软件产品开发过程系统化、规范化和标准化的要求也越来越严格。 因此，软件工程标准化、软件文档规范化，已经成为软件领域继软件工程学后，影响软件行业发展的又一个重要因素，受到软件企业的高度重视。而所有这些方面建立的标准或规范，即是软件工程标准化。 到1999年底，ISO/JTC1已制定出近40项软件工程国际标准。我国自1983年起至今，也已陆续制定、发布了20余项软件工程国家标准。 * 3. 软件工程标准化的意义 软件企业实施软件工程标准化后的益处，主要表现在以下几个方面： 1. 提高软件的可靠性、可维护性和可移植性； 2. 提高软件的生产率和软件人员的技术水平； 3. 提高软件人员之间的通信效率，减少差错和误解； 4. 有利于软件管理； 5. 有利于降低软件产品的成本和运行维护成本； 6. 有利于缩短软件开发周期。 在使用工程化的原理和方法来指导软件的开发和维护时，必须充分注意软件文档的编制和管理。 4. 软件工程标准化的类型 参照其它工程领域对工程标准划分的方法，软件工程标准主要有两种划分方法： 按标准的类型划分和按标准的范围划分。 * (1) 按标准的类型划分 主要有过程标准、产品标准、行业标准、记法标准等。 过程标准与开发一个产品或从事一项服务的一系列活动或操作有关。过程标准使用一组方法、工具和技术，给出“谁来做”、“做什么”、“如何做”、“何时做”、“何地做”及在软件工程活动中进行的不同层次工作的过程模型。 产品标准则涉及软件工程事务的格式和内容，如需求、设计、计划等。软件开发和维护活动文档化的结果就是软件产品，软件文档是软件工程活动进一步开展的基础。 软件开发作为一种行业，其行业标准涉及软件工程的所有方面，如执业认证、职业培训、产品许可等。行业标准可以等同于行业行为规范。 记法标准规定了在软件工程行业范围内，以唯一的方式进行交流的方法，如术语、表示法、语言等。它其实是一种语境规范。 (2) 按标准的范围划分 主要是根据软件的任务功能和软件生存期进行比较、判定、评价和确定软件工程标准的范围和内容。任务功能可以表示软件工程过程，可以划分为产品工程功能、验证与确认功能以及技术管理功能3个部分。 产品工程功能包括定义、生产和支持最终产品所必须的过程。验证和确认功能是检查产品质量的活动。技术管理功能是构造和控制产品工程的过程。 这3个部分并不集中在单个的软件生存周期里，而是并行进行的生产、检查和控制活动。 标准范围 标准类型 软 件 生 存 期 概念 需求 设计 实现 测试 制造 安装与检验 运行/维护 引退 过程 方法 技术 度量 产 品 需求 GB/T 9385-1988 设计 部件 描述 计划 报告 行 业 职业 道德准则 认证 特许 课程 记法 术语 表示法 GB/T 1526-1989 语言 * 根据以上两种分类方法，软件工程标准可用一张二维表格来表示。 标准范围 标准类型 过程管理 产品管理 资源管理 评审与审计 产品分析