014软件开发技术文档管理规范

目录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 封面4

3.2.2 目录6

3.2.3 版本更新说明6

3.2.4 文件内容6

3.2.5 正文格式6

3.3 文档制作工具7

4. 文档管理规范7

4.1 文档管理岗位职责7

4.2 文档的制作7

4.2.1 文档的分类、编码与标识8

4.2.2 文档的作者、修改者和打字者8

4.3 文档的收集8

4.4 文档的配置8

4.5 文档的控制8

4.6 文档的修改管理9

4.7 文档的借阅和复制管理制度9

4.8 文档的保密性9

5. 技术文档的质量评价10

1.前言

1.1 目的

软件开发的不同阶段都会产生大量的文档。为了加强管理、提高工作效率，充分借鉴前人的经验，对文档进行规范化管理是很有必要的。它对于保管在开发中形成的文档，为公司积累宝贵的技术知识的财富，为今后的软件开发工作提供第一手的宝贵资料起着重要的作用。

为了规范创智集团工程项目的开发工作，根据国家标准局制定的有关软件开发和开发文件的规范标准，结合公司的实际，制定本规范。

1.2 术语

略。

1.3 参考文献

1)《1998计算机软件工程规范----国家标准》中国标准出版社1998年

6月第一版。

2)《软件工程概论》郑人杰等清华大学出版社1998年4月第一版。

3)《实用软件工程》郑人杰等清华大学出版社1997年4月第二版。

4)《创智软件园文档管理规范》创智（湖南）软件园有限公司1996年

5月。

5)《创智软件园软件开发管理规范》创智（湖南）软件园有限公司1995

年12月。

1.4 版本说明和修改历史

本规范是在公司原有文档规范的基础上，于1999年05月份修订而成，具体的修订人员为孙继纲、赵海等。

2.软件文档

2.1 文档的定义及作用

文档（document）是指某种数据媒体和其中所记录的数据。它具有永久性，

并可以由人或机器阅读，通常仅用于描述人工可读的东西。

正确地制作和使用软件文档，可以获得如下的便利：

●提高软件开发过程的能见度。

●提高开发效率。

●作为开发人员在一定阶段的工作成果和结束标志。

●记录开发过程中的有关信息，便于协调以后的软件、开发、使用和

维护。

●便于潜在用户了解软件的功能、性能等各项指标，为他们选购符合

自己需要的软件提供依据。

2.2 软件文档的分类

对于软件文档的分类有多种方法。

从形式上分为两类：

●开发过程中可以填写的各种图表，可称之为工作表格。

●应编制的技术资料或技术管理资料，可称之为文档或文件。

按照软件文档的产生和使用范围可以分为三类：

●开发文档：软件开发过程中，作为软件开发人员前一阶段工作成果

的体现和后一阶段工作依据的文档。包括可行性研究、项目开发计

划、需求说明、数据说明、概要设计和详细设计。

●管理文档：软件开发过程中，由软件开发人员制定的需提交管理人

员的一些工作计划和工作报告，包括项目开发计划、测试计划、测

试报告、开发进度月报及项目开发总结。

●用户文档：软件开发人员为用户准备的有关该软件使用、操作、维

护的资料，包括用户手册、操作手册、维护修改建议、需求说明。

按照计算机软件产品开发文件编制指南的国家标准（GB8567-88）的要求，在一项计算机软件的开发过程中，一般地说，应该产生14种文件：

●可行性研究报告。

●项目开发计划。

●软件需求说明书。

●数据要求说明书。

●概要设计说明书。

●详细设计说明书。

●数据库设计说明书。

●用户手册。

●操作手册。

●模块开发卷宗。

●测试计划。

●测试分析报告。

●开发进度月报。

●项目开发总结报告。

2.3 软件文档的制作与软件生存周期之间的关系

一般而言，计算机软件生存周期可以分为六个阶段：

●可行性与计划研究阶段。

●需求分析阶段。

●设计阶段。

●实现阶段。

●测试阶段。

●运行与维护阶段。

2.4 文档的使用者

对于软件文档的使用人员而言，与其所承担的工作有关，具体情况如下所示。

管理人员：

●可行性研究报告。

●项目开发计划书。

●模块开发卷宗。

●开发进度月报。

●项目开发总结报告。

开发人员：

●可行性研究报告。

●项目开发计划书。

●需求分析说明书。

●概要设计说明书

●详细设计说明书

●数据库设计说明书。

●测试计划。

●测试分析报告。

维护人员：

●设计说明书。

●测试分析报告。

●模块开发卷宗。

●

最终用户：

●系统安装手册。

●用户手册。

●系统维护手册。

●系统功能说明书

3.文档编制格式规范

3.1 文档编码规则

公司所有的技术文档，都必须具有一个唯一的系列号，格式为：

PRS-PID-XX：

1)“PRS”：创智标识符（Company Flag)。

2)“PID”：项目代号。

3)“XX”：文档标识号，参见《软件开发配置管理规程》。

例如，文件号：PRS-PowerOffice-MD-01-1.0.0

表示：该文件由本公司产品PowerOffice，MD表示是管理文档，001表示是项目开发计划书，版本号1.0.0表示是PowerOffice产品1.0.0版。

3.2 文档组成格式

公司所有文档（仅一页的文件可按单页文档格式组织）由封面、目录（Content Table)、版本更新说明书（Rivision)、文件内容等组成，如图所示

图1文档组成档式

3.2.1封面

封面组成可划分为：

1. 文档号：DOC.NO. 文档系列号 (文档文件名)

字体: Arial , 小四, 加粗