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

ISO9001 质量体系作业文件质量体系作业文件 名名 称称： 软件开发技术文档管理规范软件开发技术文档管理规范 编编 号号： 版号版号 拟拟 制制： 日期日期 审审 核核：日期日期 批批 准准：日期日期 生效日期生效日期： 受控状态受控状态： 发文号发文号： 会签部门会签人/日期会签部门会签人/日期 软件开发技术文档管理规范软件开发技术文档管理规范 第第 1 页页 共共 18 页页 目录目录 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 软件开发技术文档管理规范软件开发技术文档管理规范 第第 1 页页 共共 18 页页 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 页页 共共 18 页页 2. 软件文档软件文档 2.1 文档的定义及作用文档的定义及作用 文档（document）是指某种数据媒体和其中所记录的数据。它具有永久性， 并可以由人或机器阅读，通常仅用于描述人工可读的东西。 正确地制作和使用软件文档，可以获得如下的便利： 提高软件开发过程的能见度。 提高开发效率。 作为开发人员在一定阶段的工作成果和结束标志。 记录开发过程中的有关信息，便于协调以后的软件、开发、使用和 维护。 便于潜在用户了解软件的功能、性能等各项指标，为他们选购符合 自己需要的软件提供依据。 2.2 软件文档的分类软件文档的分类 对于软件文档的分类有多种方法。 从形式上分为两类： 开发过程中可以填写的各种图表，可称之为工作表格。 应编制的技术资料或技术管理资料，可称之为文档或文件。 按照软件文档的产生和使用范围可以分为三类： 开发文档：软件开发过程中，作为软件开发人员前一阶段工作成果 的体现和后一阶段工作依据的文档。包括可行性研究、项目开发计 划、需求说明、数据说明、概要设计和详细设计。 管理文档：软件开发过程中，由软件开发人员制定的需提交管理人 员的一些工作计划和工作报告，包括项目开发计划、测试计划、测 试报告、开发进度月报及项目开发总结。 用户文档：软件开发人员为用户准备的有关该软件使用、操作、维 护的资料，包括用户手册、操作手册、维护修改建议、需求说明。 按照计算机软件产品开发文件编制指南的国家标准（GB8567-88）的要求， 在一项计算机软件的开发过程中，一般地说，应该产生 14 种文件： 可行性研究报告。 项目开发计划。 软件需求说明书。 数据要求说明书。 概要设计说明书。 详细设计说明书。 数据库设计说明书。 用户手册。 操作手册。 软件开发技术文档管理规范软件开发技术文档管理规范 第第 3 页页 共共 18 页页 模块开发卷宗。 测试计划。 测试分析报告。 开发进度月报。 项目开发总结报告。 2.3 软件文档的制作与软件生存周期之间的关系软件文档的制作与软件生存周期之间的关系 一般而言，计算机软件生存周期可以分为六个阶段： 可行性与计划研究阶段。 需求分析阶段。 设计阶段。 实现阶段。 测试阶段。 运行与维护阶段。 在软件开发的不同阶段，产生的软件文档不同，具体对应关系如下表所示。 阶段 文档 可行性研究与计划 阶段 需求分 析阶段 设计 阶段 实现 阶段 测试 阶段 运行与维 护阶段 可行性研究报告 项目开发计划 软件需求说明书 数据要求说明书 测试计划 概要设计说明书 详细设计说明书 数据库设计说明 书 模块开发卷宗 用户手册 操作手册 测试分析报告 开发进度月报 项目开发总结 2.4 文档的使用者文档的使用者 对于软件文档的使用人员而言，与其所承担的工作有关，具体情况如下所示。 管理人员： 可行性研究报告。 项目开发计划书。 软件开发技术文档管理规范软件开发技术文档管理规范 第第 4 页页 共共 18 页页 模块开发卷宗。 开发进度月报。 项目开发总结报告。 开发人员： 可行性研究报告。 项目开发计划书。 需求分析说明书。 概要设计说明书 详细设计说明书 数据库设计说明书。 测试计划。 测试分析报告。 维护人员： 设计说明书。 测试分析报告。 模块开发卷宗。 最终用户： 系统安装手册。 用户手册。 系统维护手册。 系统功能说明书 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)、文件内容等组成，如图所示 软件开发技术文档管理规范软件开发技术文档管理规范 第第 5 页页 共共 18 页页 件 件 件 件 件 件 件 件 件 件 件件 件件 件件 件 件 件 件 目 录 图图1 1文档组成档式文档组成档式 3.2.1 封面封面 封面组成可划分为： 1. 文档号文档号：DOC.NO. 文档系列号 (文档文件名) 字体: Arial , 小四, 加粗 例：DOC.NO. PRS-PID-XX (Facedoc.doc) 2. 项目名称项目名称: 中文字体: 黑体, 三号字体, 加粗 英文字体: Arial , 三号字体, 加粗 例：创智文档规范创智文档规范 3. 文档名称文档名称: 中文字体：黑体, 一号字体, 加粗 英文字体：Arial, 一号字体, 加粗 例：工程技术项目文档规范工程技术项目文档规范 4. 密级密级：英文字体: Arial, 小四字体, 加粗 划分为五类，采用下列关键词 Top Confidential High Confidential Confidential Normal General Top Confidential：绝密 产品文档 High Confidential：机密 规范、指南 Confidential：秘密 计划、管理 Normal：普通 工作岗位有关 General：明文 可以在社会上广为流传 例 : NormalNormal 软件开发技术文档管理规范软件开发技术文档管理规范 第第 6 页页 共共 18 页页 5. 版本号版本号：关键词为 Version 用 Arial 字体, 大小为小四号 例: Version V1.0.0 6. 完成日期完成日期：用Arial 字体, 大小为小四号 例: 1994.11.14. 7. 作者作者：Written By用 Arial 字体,大小为小四号, 加粗 例: WrittenWritten ByBy POWERISEPOWERISE 8. 公司公司LOGO:LOGO: 用 USABLack 字体,大小为四号, 加粗。 例: POWERISEPOWERISE 9.公司名称及版权生效年份公司名称及版权生效年份: : 关键词为：创智软件园有限公司 Powerise Software. Inc. 版权生效年限：关键词为（C）公历年号 中文字体: 黑体, 四号, 加粗 例: 创智软件园有限公司 (C)1994,1999 注：此处填写产品已经经过的年份，如注：此处填写产品已经经过的年份，如PowerLCMS,copyrights(C)1996,1998.PowerLCMS,copyrights(C)1996,1998. 英文字体: Arial , 四号, 加粗 例: PowerisePowerise Software.Inc.(C)1994,1995Software.Inc.(C)1994,1995 10. 版权申明版权申明：字体为: Arial , 小四, 加粗 例: AllAll RightRight ReservedReserved 各项安排如下图,样板范例可参见本文档的封面： 1 2 4 3 5 6 7 8 9 10 3.2.2 目录目录 可采用手工编制或使用文档编制 Microsoft Word 的自动生成目录的功能 产生文档目录。 软件开发技术文档管理规范软件开发技术文档管理规范 第第 7 页页 共共 18 页页 3.2.3 版本更新说明版本更新说明 关键词为：Revision 内容划分为：日期(Date)、理由(Reason)、更新者 (Revisor)。(首版可省略该节) 3.2.4 文件内容文件内容 文件内容每一页必须包含下列三项，缺一不可： 页首，在页首中部自动填入标题1的名称。 页脚，在页脚左部填入创智标徽POWERISEPOWERISE，右部填入页号。 正文。 如下图所示，具体设置可复制本文作模块。 标题 Powerise创智（创智标徽image） 第X页 3.2.5 正文格式正文格式 标题一：宋体、小三、粗体，左对齐； 标题二：黑体、四号、粗体，左对齐； 标题三：宋体、小四号、粗体，左对齐； 标题四：黑体、小四号、正常体，左对齐； 标题五：黑体、五号、粗体，左对齐； 正文：宋体、小四号、正常体，左对齐。 以上行距为单倍行距。 3.3 文档制作工具文档制作工具 使用何种文档制作工具，原则上没有限制，但必需考虑到文档交流的方便 性问题。因此，如果在文档的交流方面，因为文档制作工具的使用差异造成工 作上的不便，文档制作者本人应该设法解决。 用于交流和上交的文档登记说明上，应注明所使用的文档制作工具。 软件开发技术文档管理规范软件开发技术文档管理规范 第第 8 页页 共共 18 页页 4. 文档管理文档管理规范规范 4.1 文档管理岗位职责文档管理岗位职责 产生文档的单位包括：开发部的项目组和配置测试中心的配置测试组。 项目组的职责： 编写开发计划书，评审/审查通过后，向配置测试组提交，进入配 置管理。 编写阶段开发计划书、技术文档，经过评审/审查后，向配置测试 组提交，进入配置管理。 编写阶段总结报告，向配置测试组提交，进入配置管理。 配置测试组的职责： 编写配置测试评审计划书，评审/审查通过后，进入配置管理。 编写阶段计划书、配置、测试和评审文档，经过评审/审查后，进 入配置管理。 收集项目组的管理文档和技术文档 执行阶段计划书、配置、测试和评审，经过评审/审查后，进入配 置管理。 编写阶段总结报告，进入配置管理。 4.2 文档的制作文档的制作 任何软件开发技术文档的作者必须严格按照软件开发技术文档管理规范 来制作。 技术文档的制作可以由作者本人完成，这就要求各开发人员学习文档的制 作规范，按规范进行文档编写。 技术文档也可以由作者本人手工书写，交秘书来打字完成，但技术文档的 作者必须进行校对工作。 4.2.1 文档的分类、编码与标识文档的分类、编码与标识 参见软件开发配置管理规程 4.2.2 文档的作者、修改者和文档的作者、修改者和打字者打字者 对此管理的目的是明确文档的来源，使整个开发的流程清晰可查。以便今 后可就某个技术细节找到相应的人（作者）进行更进一步的探讨和学习。也便 于对某个项目的工作任务作出合理的安排。 每本文档在形成时，在封面就须写清楚文档的第一作者及其合作者。如果 文档进行了修改、改版，在版本更新说明中，还必须写清修改人。 软件开发技术文档管理规范软件开发技术文档管理规范 第第 9 页页 共共 18 页页 在对文档进行登记归档时也必须如实记录作者。其中有第一作者，修改者。 同时记录打印人和定稿打印的日期。 4.3 文档的收集文档的收集 技术文档的收集包括 2 种方式。一种是作者将完成的合乎规范的技术文档 主动交配置测试中心关于本项目指定的配置测试工程师进行配置管理。一种是 配置测试中心关于本项目的配置测试工程师，根据项目阶段任务和阶段成果的 安排，在适当的时候向相关的文档制作者收集技术文档，进行配置管理和版本 控制。 4.4 文档的配置文档的配置 与项目有关的管理文档和技术文档的管理最终统一归口于软件配置测试中 心的配置管理组。技术文档的管理方式是按部门、部门下面的项目组、项目组 的不同阶段加以配置管理和版本控制例如： 开发一部 开发二部 开发三部PTMIS 湖南人行 公安、消防 设计书类 操作手册 维护手册 方案类 测试类 开发卷宗 以上只是管理的一种形式，它是根据部门来分类。另外还可以根据其它特 征来分类。这些特征有时间、作者、部门、项目、文档类别等。具体采用什么 样的特征可根据具体情况进行适当的分类。 在对文档进行管理时，必须对每一份正式的文档进行详细的登记。登记时 的原则是：手续严密、格式清晰醒目、简化适用、登记项目完整详尽。这样在 对文档进行管理时便于查找文档和检查文档的运转情况。一般采用簿式登记， 以便清晰可查。 4.5 文档的控制文档的控制 为保持文档和程序产品的一致性，保持各种文件之间的一致性和文件的安 全性，需要对文档进行控制，具体表现在： 应该有文档管理员集中保管本项目现有全部文档的主文本两套，由 软件开发技术文档管理规范软件开发技术文档管理规范 第第 10 页页 共共 18 页页 其负责保管 每一份提交给文档管理人员的文档必需具有编写人、审核人和批准 人的签字 两套文本的内容一致，其中一套可以出借，另一套绝对不可以出借 文档的借阅和归还必需有出借和注销的手续 项目组种的个人文档必需和整个项目的主文档的内容和版本一致 一份文档如果被新文档更新，原文件必需注销 4.6 文档的修改管理文档的修改管理 在项目开发过程中，项目组内部的任何人都可以提议对开发工作的文件成 果进行修改，但必需遵循如下的步骤： 提议：项目组内部任何一个人都可以填写修改建议表，提出对文档 的修改建议 评议：由项目负责人或项目负责人制定指定的人员对文档修改提议 进行评议，包括审查该项修改的必要性、影响范围、研究进行修改 的方法、步骤和实施计划 审核：由项目负责人进行审核，包括合适修改的目的和要求、核实 修改活动将带来的影响、审核修改活动计划是否可行 批准：由开发单位的部门负责人进行批准，主要是决断修改工作中 各项活动的先后顺序及各自完成日期，以保证整个开发工作按园丁 计划日期完成 实施：由项目负责人按已批准的修改活动计划，安排各项修改活动 的负责人进行修改，建立修改记录、产生新的文件以取代原有文档， 最后把文档交付文档管理员，并奋发给有关的持有者 4.7 文档的借阅和复制管理制度文档的借阅和复制管理制度 技术文档的借阅包括 3 种情况。一种是在软件开发部门内部的技术文档借 阅。一种是项目组内部的文档借阅，一种是已经配置管理于配置测试中心的技 术文档的借阅。 对于部门内部的技术文档借阅，申请人必须拥有部门经理的签名许可。 对于项目组内部的技术文档借阅，申请人必须拥有项目经理或总设计师的 签名许可。 对于配置测试中心特定技术文档的借阅，必须拥有主管技术副总裁或技术 总监的签名许可。 4.8 文档的保密性文档的保密性 对于任何一种技术文档，必须按密级进行管理，技术文档的密级在制作规 范中已经说明。借阅制度如下： 明文（General）：可以自由借阅，只要办理一下借阅手续即可。出借 软件开发技术文档管理规范软件开发技术文档管理规范 第第 11 页页 共共 18 页页 的文档要登记文档份数，文件名，借阅人，预期归还时间。如须长期 使用，要保留复印件； 普通（Normal）：只有本公司特定岗位的技术人员才可以使用的文档。 秘密（Confidential）：管理类计划和总结文档 机密（High Confidential）：管理规程、编写规范等文档。 绝密（Top Confidential）：产品文档。 借出的文档要定期催还，因丢失文件、泄密造成的后果由借阅人承担。 关于技术文档的复制（拷贝和或打印）工作，必须依照上述的借阅制度进 行。 5. 技术文档的质量评价技术文档的质量评价 高质量的文档应当体现在以下几个方面： 规范性：符合公司关于相关类型的文档制作规范 针对性：文档编制以前应当分清读者对象。按不同的类型、不同层 次的读者，决定怎样适应他们的需要 精确性：文档的行文应当十分准确，不能出现多义性的描述 清晰性：文档编写应力求简明，如有可能，配以适当的图表，以增 强其清晰性。 完整性：任何一个文档都应当是完整的、独立的，应自成体系。 灵活性：各个不同软件项目，其规模和复杂程度有着许多实际差别， 不能一律看待 软件开发技术文档管理规范软件开发技术文档管理规范 第第 12 页页 共共 18 页页 下面是赠送的中秋节演讲辞，不下面是赠送的中秋节演讲辞，不 需要的朋友可以下载后编辑删除！谢谢需要的朋友可以下载后编辑删除！谢谢 中秋佳节演讲词推荐中秋佳节演讲词推荐 中秋,怀一颗感恩之心 老师们，同学们： 秋浓了，月圆了，又一个中秋要到了!本周日，农历的八月十五，我国的传统节 日中秋节。中秋节，处在一年秋季的中期，所以称为“中秋”，它仅仅次 于春节，是我国的第二大传统节日。 中秋的月最圆，中秋的月最明，中秋的月最美，所以又被称为“团圆节”。 金桂飘香，花好月圆，在这美好的节日里，人们赏月、吃月饼、走亲访友 无论什么形式，都寄托着人们对生活的无限热爱和对美好生活的向往。 中秋是中华瑰宝之一，有着深厚的文化底蕴。中国人特别讲究亲情，特别珍视 团圆，中秋节尤为甚。中秋，是一个飘溢亲情的节日;中秋，是一个弥漫团圆的 软件开发技术文档管理规范软件开发技术文档管理规范 第第 13 页页 共共 18 页页 时节。这个时节，感受亲情、释放亲情、增进亲情;这个时节，盼望团圆、追求 团圆、享受团圆这些，都已成为人们生活的主旋律。 同学们，一定能背诵出许多关于中秋的千古佳句，比如“举头望明月，低头思 故乡”、“但愿人长久，千里共婵娟”、“海上生明月，天涯共此时”这 些佳句之所以能穿透历史的时空流传至今，不正是因为我们人类有着的共同信 念吗。 中秋最美是亲情。一家人团聚在一起，讲不完的话，叙不完的情，诉说着人们 同一个心声：亲情是黑暗中的灯塔，是荒漠中的甘泉，是雨后的彩虹 中秋最美是思念。月亮最美，美不过思念;月亮最高，高不过想念。中秋圆月会 把我们的目光和思念传递给我们想念的人和我们牵挂的人，祝他们没有忧愁， 永远幸福，没有烦恼，永远快乐! 一、活动主题：游名校、赏名花，促交流， 增感情 二、活动背景：又到了阳春三月，阳光明媚，微风吹拂，正是踏青春游的好时 节。借春天万物复苏之际，我们全班聚集在一起，彼此多一点接触，多一点沟 通，共话美好未来，与此同时，也可以缓解一下紧张的学习压力。 相信在这次 春游活动中，我们也能更亲近的接触自然，感悟自然，同时吸收万物之灵气的 同时感受名校的人文气息。 三、活动目的： 1. 丰富同学们的校园生活，陶冶情操。 软件开发技术文档管理规范软件开发技术文档管理规范 第第 14 页页 共共 18 页页 2. 领略优美自然风光，促进全班同学的交流，营造和谐融洽的集体氛围。 3. 为全体同学营造一种轻松自由的气氛，又可以加强同学们的团队意识。 4. 有 效的利用活动的过程及其形式，让大家感受到我们班级的发展和进步。 四、活动时间：XX 年 3 月 27 日星期四 五、活动参与对象：房产 Q1141 全体及“家属” 六、活动地点：武汉市华中农业大学校内 七、活动流程策划： 1、27 日 8 点在校训时集合，乘车 2、9 点前往华农油菜基地、果园，赏花摄影 3、10 点 30，回农家乐开始做饭，进行“我是厨王”大比拼 4、1 点 30，收拾食品残物，开始集体活动 5、4 点，乘车返校 八、职能分工及责任定岗 1、调研组：负责前期的选址、