2014软件开发技术文档管理规.docVIP

ISO9001质量体系作业文件 名 称： 软件开发技术文档管理规范 编 号： 版号 拟 制： 日期 审 核： 日期 批 准： 日期 生效日期： 受控状态： 发文号： 会签部门 会签人/日期 会签部门 会签人/日期 目录 1. 前言 1 1.1 目的 1 1.2 术语 1 1.3 参考文献 1 1.4 版本说明和修改历史 1 2. 软件文档 1 2.1 文档的定义及作用 1 2.2 软件文档的分类 2 2.3 软件文档的制作与软件生存周期之间的关系 3 2.4 文档的使用者 3 3. 文档编制格式规范 4 3.1 文档编码规则 4 3.2 文档组成格式 4 3.2.1 封面 5 3.2.2 目录 6 3.2.3 版本更新说明 6 3.2.4 文件内容 6 3.2.5 正文格式 7 3.3 文档制作工具 7 4. 文档管理规范 7 4.1 文档管理岗位职责 7 4.2 文档的制作 8 4.2.1 文档的分类、编码与标识 8 4.2.2 文档的作者、修改者和打字者 8 4.3 文档的收集 8 4.4 文档的配置 9 4.5 文档的控制 9 4.6 文档的修改管理 9 4.7 文档的借阅和复制管理制度 10 4.8 文档的保密性 10 5. 技术文档的质量评价 11 前言 目的 软件开发的不同阶段都会产生大量的文档。为了加强管理、提高工作效率，充分借鉴前人的经验，对文档进行规范化管理是很有必要的。它对于保管在开发中形成的文档，为公司积累宝贵的技术知识的财富，为今后的软件开发工作提供第一手的宝贵资料起着重要的作用。 为了规范创智集团工程项目的开发工作，根据国家标准局制定的有关软件开发和开发文件的规范标准，结合公司的实际，制定本规范。 术语 略。 参考文献 《1998计算机软件工程规范----国家标准》 中国标准出版社 1998年6月第一版。 《软件工程概论》 郑人杰等 清华大学出版社 1998年4月第一版。 《实用软件工程》 郑人杰等 清华大学出版社 1997年4月第二版。 《创智软件园文档管理规范》 创智（湖南）软件园有限公司 1996年5月。 《创智软件园软件开发管理规范》 创智（湖南）软件园有限公司 1995年12月。 版本说明和修改历史 本规范是在公司原有文档规范的基础上，于1999年05月份修订而成，具体的修订人员为孙继纲、赵海等。 软件文档 文档的定义及作用 文档（document）是指某种数据媒体和其中所记录的数据。它具有永久性，并可以由人或机器阅读，通常仅用于描述人工可读的东西。 正确地制作和使用软件文档，可以获得如下的便利： 提高软件开发过程的能见度。 提高开发效率。 作为开发人员在一定阶段的工作成果和结束标志。 记录开发过程中的有关信息，便于协调以后的软件、开发、使用和维护。 便于潜在用户了解软件的功能、性能等各项指标，为他们选购符合自己需要的软件提供依据。 软件文档的分类 对于软件文档的分类有多种方法。 从形式上分为两类： 开发过程中可以填写的各种图表，可称之为工作表格。 应编制的技术资料或技术管理资料，可称之为文档或文件。 按照软件文档的产生和使用范围可以分为三类： 开发文档：软件开发过程中，作为软件开发人员前一阶段工作成果的体现和后一阶段工作依据的文档。包括可行性研究、项目开发计划、需求说明、数据说明、概要设计和详细设计。 管理文档：软件开发过程中，由软件开发人员制定的需提交管理人员的一些工作计划和工作报告，包括项目开发计划、测试计划、测试报告、开发进度月报及项目开发总结。 用户文档：软件开发人员为用户准备的有关该软件使用、操作、维护的资料，包括用户手册、操作手册、维护修改建议、需求说明。 按照计算机软件产品开发文件编制指南的国家标准（GB8567-88）的要求，在一项计算机软件的开发过程中，一般地说，应该产生14种文件： 可行性研究报告。 项目开发计划。 软件需求说明书。 数据要求说明书。 概要设计说明书。 详细设计说明书。 数据库设计说明书。 用户手册。 操作手册。 模块开发卷宗。 测试计划。 测试分析报告。 开发进度月报。 项目开发总结报告。 软件文档的制作与软件生存周期之间的关系 一般而言，计算机软件生存周期可以分为六个阶段： 可行性与计划研究阶段。 需求分析阶段。 设计阶段。 实现