[定稿]软件文档管理指南GBT-16680—1996.pdf

[定稿]软件文档管理指南GBT16680—1996

软件文档管理指南GBT16680—1996

软件文档管理指南GB/T16680—1996

《GB/T16680—1996软件文档管理指南》(由原国家技术监督局于1996年12

月18日发布，1997年7月1日起实施，

该标准为那些对软件或基于软件的产品的开发负有职赍的管理者提供软件文档

的管理指南。该标准的目的在于协助管理者在他们的机构中产生有效的文档。该标

准涉及策略、标准、规程、资源和计划，管理者必须关注这些内容，以便有效地管

理软件文档。根据该标准，文档是指一种数据媒体和其上所记录的数据。它具有永

久性并可以由人或机器阅读。通常倾于描述人工可读的内容，例如，技术文件、设

计文件、版本说明文件。

软件文档的作用:管理依据、任务之间联系的凭证、质量保证、培训与参考;软

件维护支持、历史档案。

软件文档可归入三种类别:开发文档(描述开发过程本身)、产品文档(描述开发

过程的产物)、管理文档(记录项目管理的信息)。

1.文档计划

文档计划是指一个描述文档编制工作方法的管理用文档。该计划主要描述要编

制什么类型的文档，这些文档的内容是什么，何时编写，由谁编写，如何编写，以

及什么是影响期望结果的可用资源和外界因素。

文档计划一般包括以下几方面的内容:

(1)列出应编制文档的目录。

(2)提示编制文档应参考的标准。

(3)指定文档管理员。

(4)提供编制文档所需要的条件，落实文档编写人员、所需经费以及编制工具

等。

(5)明确保证文档质量的方法，为了确保文档内容的正确性、合理性，应采取

一定的措施，如评审、鉴定等等。

(6)绘制进度表，以图表形式列出在软件生存期各阶段应产生的文档、编制人

员、编制日期、完成日期、评审日期等。

此外，文档计划规定每个文档要达到的质量等级，以及为达到期望结果必须考

虑哪些外部因素。文档计划还确定该计划和文档的分发，并且明确叙述参与文档工

作的所有人员的职贲。

2.开发文档

开发文档是描述软件开发过程，包括软件需求、软件设计、软件测试、保证软

件质量的一类文档，开发文档也包括软件的详细技术描述(程序逻辑、程序间相互

关系、数据格式和存储等)。开发文档起到如下五种作用:

(1)它们是软件开发过程中包含的所有阶段之间的通信工具，它们记录生成软

件需求、设计、编码和测试的详细规定和说明。

(2)它们描述幵发小组的职责。通过规定软件、主题事项、文档编制、

质量保证人员以及包含在开发过程中任何其他事项的角色来定义做什么、如何

做和何时做。

(3)它们用作检验点而允许管理者评定开发进度，如果开发文档丢失、不完整

或过时，管理者将失去跟琮和控制软件项目的一个重要工具。

(4)它们形成了维护人员所要求的基本软件文档。而这些支持文档可作为产品

文档的一部分。

(5)它们记录软件开发的历史。基本的开发文挡有可行性研究和项目任务书;需

求规格说明:功能规格说明:设计规格说明，包括程序和数据规格说明;开发计划;软

件集成和測试计划;质量保证计划、标准、进度:安全和测试信息。

3.产品文档

产品文档规定关于软件产品的使用、维护、增强、转换和传输的信息。产品文

档起到如下三种作用:

(1)为使用和运行软件产品的任何人规定培训和参考信息;

(2)使得那些未参加本软件开发的程序员维护它;

(3)促进软件产品的市场流通或提髙可接受性。

产品文档用于下列类型的读者:

(1)用户。他们利用软件输入数据、检索信息和解决问题;

(2)运行者。他们在计算机系统上运行软件;

(3)维护人员。他们维护、增强或变更软件。

产品文档包括如下内容:

(1)用于管理者的指南和资料，他们监督软件的使用;

(2)宣传资料。通告软件产品的可用性并详细说明它的功能、运行环境等:

(3)一般信息。对任何有兴趣的人描述软件产品。

基本的产品文档有培训手册;参考手册和用户指南;软件支持手册;产品手册和

广告信息。

4.管理文档

管理文档建立在项目信息的基础上，诸如:

(1)开发过程的每个阶段的进度和进度变更的记录;

(2)软件变更情况的记录;

(3)相对于开发的判定记录;

(4)职责定义。

这种文档从管理的角度规定涉及软件生存的