软件工程文档标准.pdf

第5 章 软件工程文档标准 5.1 大纲要求 本章对应《信息系统项目管理师考试大纲》第 6 章 6.2.3 节的内容。 考试大纲中对本章的要求有：  《软件文档管理指南》GB/T 16680—1996  《计算机软件产品开发文件编制指南》GB/T 8567—1988  《计算机软件需求说明编制指南》GB/T 9385—1988 5.2 要点详解 软件工程文档标准主要涉及到软件文档管理指南、计算机软件产品开发文件编制指 南和计算机软件需求说明编制指南，应该关注三种文档分类标准、四种文档级别以及 14 种开发文件的内容。 5.2.1 《软件文档管理指南》GB/T 16680—1996 1．重要概念 无 2 ．数字规定 无 3 ．情形列举 软件文档可区分为开发文档、产品文档和管理文档三类文档，表 5.1 描述了三类文 档的定义、作用以及种类。 表 5.1 文档种类比较表 文档 定 义 作 用 种 类 种类 开发文档是描述 1．它们是软件开发过程中包含的所有阶段之间的 可行性研究和项目任 软件开发过程， 通信工具，它们记录生成软件需求、设计、编码和 务书 开发 包括软件需求、 测试的详细规定和说明。 需求规格说明书 文档 软件设计、软件 2 ．它们描述开发小组的职责。通过软件、主题事 功能规格说明书 测试、软件质量 项、文档编制、质量保证人员以及包含在开发过 设计规格说明书，包括 52 信息系统项目管理师考试辅导（针对下午考试）（第2 版） 续表 文档 定 义 作 用 种 类 种类 保证的一类文 程中任何其他事项的角色来定应做什么、如何做和 程序和数据规格说明 档，开发文档也 何时做 开发计划 包括软件的详细 3 ．它们用作检验点而允许管理者评定开发进度。 软件集成和测试计划 开发 技术描述（程序 如果开发文档丢失、不完整或过时，管理者将失去跟 质量保证计划、标准、 文档 逻辑、程序间的 踪和控制软件项目的一个重要工具 进度 相互关系、数据 4 ．它们形成了维护人员所要求的基本的软件支持文 安全和测试信息 格式和存储等） 档。而这些支持文档可作为产品文档的一部分 5 ．它们记录软件开发的历史 产品文档规定关 1．为使用和运行软件产品的任何人规定培训和参 培训手册 产品 于软件产品的使 考信息 参考手册和用户指南 文档 用维护增强转换 2 ．使得那些未参加开发本软件的程序员维护它 软件支持手册 和传输的信息 3 ．促进软件产品的市场流通或提高可接受性 产品手册和信息广告 这种文档建立在 项目管理信息的 基础上，诸如开 发过程的每个阶 管理 段的进度和进度 文档 变更的记录；软 件变更情况的记 录；相对于开发 的判定记录；职 责定义 根据软件文档质量要求，可以将软件文档的重要性划分为四个等级，参见表 5.2 。 表 5.2 文档的四个级别 文 档 级 别