软件工程第14章 软件工程标准及软件文档.pptVIP

标准化是工程化的基石。软件组织是实施软件工程标准的 基层单位，软件工程标准最终要体现在软件工程项目的各项 活动中，因此，软件组织应该重视标准化工作。 为了在软件组织内开展好标准的实施工作，有如下建议： （1）安排专人负责标准或规范工作。 （2）参考国际标准、国家标准或行业标准，制定适用于本 组织的规范或企业标准，编制本组织的软件工程标准化手 册。 （3）制定本组织的软件工程规范或标准时最好吸收有经验 的软件工程师参加，让他们充分理解开发和实施标准的意 义，以及他们在贯彻实施标准中的责任。 14.5 软件组织内的标准化工作 （4）适时组织有关软件工程标准化工作的培训。 （5）为适应软件工程发展的形势，软件组织所制定的标准 或规范需要及时地加以审查和更新。 （6）贯彻标准的一个值得提倡的做法是以辅助工具相支 持。其目的在于提高贯彻标准的效率，减少某些烦琐的工 作，这样做标准就更加容易被软件人员接受。 14.5 软件组织内的标准化工作 文档（document）是指某种数据媒体和其中所记录的数 据。它具有永久性，并可以由人或机器阅读，通常仅用于描 述人工可读的东西。在软件工程中，文档常常用来表示对活 动、需求、过程或结果进行描述、定义、规定、报告或认证 的任何书面或图示的信息。它们描述和规定了软件设计和实 现的细节，说明使用软件的操作命令。文档也是软件产品的 一部分，没有文档的软件就不称其为软件。软件文档的编 制（documentation）在软件开发工作中占有突出 的地位和相当大的工作量。 14.6 软件文档的作用和分类 什么是文档 在软件的生产过程中，总是伴随着大量的信息要记录、要 使用，因此，软件文档不仅在软件开发过程中而且在整个生 存期中都起着重要的作用。 ① 提高软件开发过程的能见度。 ② 提高开发效率。 ③ 作为开发人员在一定阶段的工作成果和结束标志。 ④ 记录开发过程中的有关信息，便于协调以后的软件产品使 用和维护。 14.6 软件文档的作用和分类 软件文档的作用 ⑤ 提供对软件的运行、维护和培训的有关信息，便于管理 人员、开发人员、操作人员和用户之间的协作、交流和了 解。使软件开发活动更科学、更有成效。 ⑥ 便于潜在用户了解软件的功能、性能等各项指标，为他 们选购符合自己需要的软件提供依据。 文档在各类人员、计算机之间的多种桥梁作用如下图所 示。 14.6 软件文档的作用和分类 软件文档从形式上来看，大致可分为两类：一类是开 发过程中填写的各种图表，可称之为工作表格；另一类是 应编制的技术资料或技术管理资料，可称之为文档或文 件。 按照文档产生和使用的范围，软件文档大致可分为3 类： ① 开发文档：这类文档是在软件工程活动中，作为软件 工程人员的阶段工作成果和后继阶段工作的依据，如软件 需求规格说明、软件设计说明、接口设计说明、可行性分 析（研究）报告等。 文档的分类 14.6 软件文档的作用和分类 ② 管理文档：这类文档是在软件工程活动中，为配合项目 管理工作而编制的一些管理性文件，使管理人员能够根据这 些文档更好地了解和控制项目的进程、工作的质量、成果、 资源的使用等，如软件（项目）开发计划、测试计划、软件 配置管理计划、软件质量保证计划、软件测试报告、开发进 度月报、项目开发总结报告等。 ③ 用户文档：这类文档是软件工程人员为用户准备的有关 该软件使用、操作、维护的参考文件，包括用户手册、操作 手册、软件需求规格说明、接口需求规格说明、软件产品规 格说明、软件版本说明等。 14.6 软件文档的作用和分类 在中华人民共和国国家质量监督检验检疫总局和中国国 家标准化委员会联合发布的GB/T 8567—2006《计算机软 件文档编制规范》中给出了25种软件文档编制要点。对于 一般的工程项目，在软件的生存周期中建议利用其中的17 种基本文档，它们是： a．可行性分析（研究）报告； b．软件（或项目）开发计划； c．软件需求规格说明； d．接口需求规格说明； e．系统/子系统设计（结构设计）说明； f．软件（结构）设计说明； 14.6 软件文档的作用和分类 文档的内容 g．接口设计说明； h．数据库（顶层）设计说明； i．用户手册； j．测试计划； k．测试报告； l．软件配置管理计划； m．软件质量保证计划； n．开发进度月报； o．项目开发总结报告； p．软件产品规格说明； q．软件版本说明。 14.6 软件文档的作用和分类 下面对上一节介绍的17种基本文档的内容要求做简要说 明。 （1）可行性分析（研究）报告：该报告是项目初期所作项 目策划的结论，报告应注重分析项目的要求；项目的目标和 环境；阐述几种可供选择的方案；