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

《软件开发技术文档管理规范》由会员分享，可在线阅读，更多相关《软件开发技术文档管理规范（13页珍藏版）》请在金锄头文库上搜索。

1、软件开发因果图制作指导书 ISO9001质量体系作业文件名 称： 软件开发技术文档管理规范编 号： 版号 拟 制： 日期 审 核：日期 批 准：日期生效日期： 受控状态： 发文号：会签部门会签人/日期会签部门会签人/日期PowerisePRS_SCTC创智软件园配置测试中心 第2页 共1页软件开发技术文档管理规范目录1.前言11.1目的11.2术语11.3参考文献11.4版本说明和修改历史12.软件文档12.1文档的定义及作用12.2软件文档的分类22.3软件文档的制作与软件生存周期之间的关系32.4文档的使用者33.文档编制格式规范43.1文档编码规则43.2文档组成格式43.2.1封面53

2、.2.2目录63.2.3版本更新说明63.2.4文件内容63.2.5正文格式73.3文档制作工具74.文档管理规范74.1文档管理岗位职责74.2文档的制作84.2.1文档的分类、编码与标识84.2.2文档的作者、修改者和打字者84.3文档的收集84.4文档的配置94.5文档的控制94.6文档的修改管理94.7文档的借阅和复制管理制度104.8文档的保密性105.技术文档的质量评价11 第1页 共13页1. 前言1.1 目的软件开发的不同阶段都会产生大量的文档。为了加强管理、提高工作效率，充分借鉴前人的经验，对文档进行规范化管理是很有必要的。它对于保管在开发中形成的文档，为公司积累宝贵的技术知

3、识的财富，为今后的软件开发工作提供第一手的宝贵资料起着重要的作用。 为了规范创智集团工程项目的开发工作，根据国家标准局制定的有关软件开发和开发文件的规范标准，结合公司的实际，制定本规范。1.2 术语 略。1.3 参考文献1) 1998计算机软件工程规范-国家标准 中国标准出版社 1998年6月第一版。2) 软件工程概论 郑人杰等 清华大学出版社 1998年4月第一版。3) 实用软件工程 郑人杰等 清华大学出版社 1997年4月第二版。4) 创智软件园文档管理规范 创智（湖南）软件园有限公司 1996年5月。5) 创智软件园软件开发管理规范 创智（湖南）软件园有限公司 1995年12月。1.4

4、版本说明和修改历史 本规范是在公司原有文档规范的基础上，于1999年05月份修订而成，具体的修订人员为孙继纲、赵海等。2. 软件文档2.1 文档的定义及作用 文档（document）是指某种数据媒体和其中所记录的数据。它具有永久性，并可以由人或机器阅读，通常仅用于描述人工可读的东西。正确地制作和使用软件文档，可以获得如下的便利：l 提高软件开发过程的能见度。l 提高开发效率。l 作为开发人员在一定阶段的工作成果和结束标志。l 记录开发过程中的有关信息，便于协调以后的软件、开发、使用和维护。l 便于潜在用户了解软件的功能、性能等各项指标，为他们选购符合自己需要的软件提供依据。2.2 软件文档的分

5、类对于软件文档的分类有多种方法。从形式上分为两类：l 开发过程中可以填写的各种图表，可称之为工作表格。l 应编制的技术资料或技术管理资料，可称之为文档或文件。按照软件文档的产生和使用范围可以分为三类：l 开发文档：软件开发过程中，作为软件开发人员前一阶段工作成果的体现和后一阶段工作依据的文档。包括可行性研究、项目开发计划、需求说明、数据说明、概要设计和详细设计。l 管理文档：软件开发过程中，由软件开发人员制定的需提交管理人员的一些工作计划和工作报告，包括项目开发计划、测试计划、测试报告、开发进度月报及项目开发总结。l 用户文档：软件开发人员为用户准备的有关该软件使用、操作、维护的资料，包括用户

6、手册、操作手册、维护修改建议、需求说明。按照计算机软件产品开发文件编制指南的国家标准（GB8567-88）的要求，在一项计算机软件的开发过程中，一般地说，应该产生14种文件：l 可行性研究报告。l 项目开发计划。l 软件需求说明书。l 数据要求说明书。l 概要设计说明书。l 详细设计说明书。l 数据库设计说明书。l 用户手册。l 操作手册。l 模块开发卷宗。l 测试计划。l 测试分析报告。l 开发进度月报。l 项目开发总结报告。2.3 软件文档的制作与软件生存周期之间的关系 一般而言，计算机软件生存周期可以分为六个阶段：l 可行性与计划研究阶段。l 需求分析阶段。l 设计阶段。l 实现阶段。l

7、 测试阶段。l 运行与维护阶段。 在软件开发的不同阶段，产生的软件文档不同，具体对应关系如下表所示。 阶段 文档 可行性研究与计划阶段需求分析阶段设计阶段实现阶段测试阶段运行与维护阶段可行性研究报告项目开发计划软件需求说明书数据要求说明书测试计划概要设计说明书详细设计说明书数据库设计说明书模块开发卷宗用户手册操作手册测试分析报告开发进度月报项目开发总结2.4 文档的使用者 对于软件文档的使用人员而言，与其所承担的工作有关，具体情况如下所示。管理人员：l 可行性研究报告。l 项目开发计划书。l 模块开发卷宗。l 开发进度月报。l 项目开发总结报告。开发人员：l 可行性研究报告。l 项目开发计划书

8、。l 需求分析说明书。l 概要设计说明书l 详细设计说明书l 数据库设计说明书。l 测试计划。l 测试分析报告。维护人员：l 设计说明书。l 测试分析报告。l 模块开发卷宗。l最终用户：l 系统安装手册。l 用户手册。l 系统维护手册。l 系统功能说明书3. 文档编制格式规范3.1 文档编码规则公司所有的技术文档，都必须具有一个唯一的系列号，格式为： PRS-PID-XX：1) “PRS”：创智标识符（Company Flag)。2) “PID”：项目代号。3) “XX”：文档标识号，参见软件开发配置管理规程。 例如，文件号：PRS-PowerOffice-MD-01-1.0.0 表示：该文件

9、由本公司产品PowerOffice，MD表示是管理文档，001表示是项目开发计划书，版本号1.0.0表示是PowerOffice产品1.0.0版。3.2 文档组成格式 公司所有文档（仅一页的文件可按单页文档格式组织）由封面、目录（Content Table)、版本更新说明书（Rivision)、文件内容等组成，如图所示 图1文档组成档式3.2.1 封面 封面组成可划分为：1. 文档号：DOC.NO. 文档系列号 (文档文件名)字体: Arial , 小四, 加粗例：DOC.NO. PRS-PID-XX (Facedoc.doc)2. 项目名称: 中文字体: 黑体, 三号字体, 加粗英文字体:

10、Arial , 三号字体, 加粗例：创智文档规范3. 文档名称: 中文字体：黑体, 一号字体, 加粗英文字体：Arial, 一号字体, 加粗例：工程技术项目文档规范4. 密级：英文字体: Arial, 小四字体, 加粗划分为五类，采用下列关键词Top ConfidentialHigh ConfidentialConfidentialNormalGenerall Top Confidential：绝密产品文档l High Confidential：机密规范、指南l Confidential：秘密计划、管理l Normal：普通工作岗位有关l General：明文可以在社会上广为流传例 : Nor

11、mal5. 版本号：关键词为 Version 用 Arial 字体, 大小为小四号例: Version V1.0.06. 完成日期：用Arial 字体, 大小为小四号例: 1994.11.14.7. 作者：Written By用 Arial 字体,大小为小四号, 加粗例: Written By POWERISE8. 公司LOGO: 用 USABLack 字体,大小为四号, 加粗。例: POWERISE9.公司名称及版权生效年份:关键词为：创智软件园有限公司 Powerise Software. Inc.版权生效年限：关键词为（C）公历年号中文字体: 黑体, 四号, 加粗 例: 创智软件园有限公

12、司 (C)1994,1999 注：此处填写产品已经经过的年份，如PowerLCMS,copyrights(C)1996,1998.英文字体: Arial , 四号, 加粗 例: Powerise Software.Inc.(C)1994,199510. 版权申明：字体为: Arial , 小四, 加粗例: All Right Reserved 各项安排如下图,样板范例可参见本文档的封面： 3.2.2 目录 可采用手工编制或使用文档编制 Microsoft Word 的自动生成目录的功能产生文档目录。3.2.3 版本更新说明 关键词为：Revision 内容划分为：日期(Date)、理由(Reason)、更新者(Revisor)。(首版可省略该节)3.2.4 文件内容文件内容每一页必须包含下列三项，缺一不可：l 页首，在页首中部自动填入标题1的名称。l 页脚，在页脚左部填入创智标徽POWERISE，右部填入页号。l 正文。如下图所示，具体设置可复制本文作模块。 标题Powerise创智（创智标徽image） 第X页3.2.5 正文格式标题一：宋体、小三、粗体，左对齐；标题二：黑体、四号、粗体，左对齐；标题三：宋体、小四号、粗体，左对齐；标题四：黑体、小四号、正常体，左对齐；标题五：黑体、五号、粗体，左对齐；正文：宋体、小四号、正常体，左对齐。以上行