软件项目管理培训讲座系列之三——文档管理规范.pdf

软件项目管理培训讲座 系列之三——文档管理规范 主讲人：史广顺 内容提要 文档的分类和等级 文档管理的原则和方法 文档示例与讨论 2011年9月7日 软件项目管理培训之三——文档规范 2 为什么需要文档管理？ 项目管理的依据 了解进度、分析问题，提供项目可预见性 工作交流的凭证 口说无凭，立字为据 软件测试的基础 没有文档，测试人员无法展开工作 培训用户的参考 帮助外界人员了解项目内幕 技术支持的帮手 帮助技术支持人员熟悉系统、分析错误、解决问题 记录历史的必须 软件最大的价值在于可复用性 2011年9月7日 软件项目管理培训之三——文档规范 3 为什么需要文档管理？ 按规范要求生成一整套文档的 按规范要求生成一整套文档的 过程，就是按照软件开发规范 过程，就是按照软件开发规范 完成一个软件开发的过程。 完成一个软件开发的过程。 2011年9月7日 软件项目管理培训之三——文档规范 4 编写文档的基本思路 明确文档范围，避免空泛浮躁 大而全的文档是没有用的 定位读者角度，防止对牛弹琴 以读者能够理解作为编写文档的标准 规范名词称谓，保持前后一致 统一的名词和称谓，会降低文档的歧义性 注重版本控制，切忌顾此失彼 不同阶段的文档记录了项目开发的完整过程 应用图文表格，保证内容清晰 简洁的图形和表格胜过前言万语 2011年9月7日 软件项目管理培训之三——文档规范 5 文档的分类（1） 类型 读者 时间 可行性研究报告 管理/研发人员 可行性研究与计划阶段 项目开发计划 管理/研发人员 可行性研究、需求分析阶段 设 需求规格说明书 研发人员 需求分析阶段 计 功能规格说明书 研发人员 需求分析阶段 开 概要设计说明书 研发/维护人员 设计阶段 发 详细设计说明书 研发/维护人员 设计阶段 类 数据库设计说明书 研发/维护人员 设计阶段 模块开发卷宗 管理/研发/维护人员 实现、测试阶段 测试计划 研发人员 需求分析、设计阶段 测试分析报告 研发/维护人员 测试阶段 管 开发进度月报 管理人员 贯穿整个开发过程 理 项目开发总结 管理人员 测试阶段 类 职责定