软件项目文档管理ch.pptVIP

第 10 章 IT软件项目文档管理 （1次、2课时） 第10章 IT软件项目文档管理 10.1 软件项目文档管理概述 10.2 项目文档的质量 10.3 项目文档准备 10.4 主要项目文档 10.5 思考题 10.1 软件项目文档管理概述 10.1.1 项目文档管理的概念 10.1.2 项目文档的分类 10.1.3 过程文档 10.1.4 产品文档 10.1.1 项目文档管理的概念 能作为开发组员之间交流沟通的媒介。 能为软件项目的维护工程师提供有关信息系统的资料和知识库。 能为项目管理者提供项目计划、预算、开发进度等各方面的信息。 能作为最终用户或管理员的用户手册，使用户知道如何使用、维护及管理系统。 10.1.2 项目文档的分类 过程文档，是指那些记录软件项目开发和维护过程的文档资料，项目的计划、进度、过程质量、组织及项目标准等都是过程文档。 产品文档，是那些描述正在开发的产品的资料。这类文档又可以分为从软件工程师开发和维护系统的角度描述产品的系统文档，以及主要以客户为对象描述产品的用户文档。 10.1.3 过程文档 软件项目计划、预测和进度安排文档：这些文档由项目经理负责产生，以便预测和控制软件的开发过程。 相关报告：这些文档用来报告在软件开发过程中，资源是如何分配和利用的。 标准报告：这些文档规定了软件过程应该如何实现，这些可以是国际标准、国家标准、行业标准等。 工作文档：这些文档是在项目开发中最主要的交流沟通工具，记录了软件项目开发中软件工程师的想法等。 备忘录及电子信息：主要记录了每天项目经理和开发人员之间的详细交流信息。 10.1.4 产品文档 (1) 系统功能描述 (2) 初级使用手册 (3) 系统参考手册 (4) 系统安装文档 (5) 系统管理员手册 10.1.4 产品文档 10.1.4 产品文档 需求文档及相关的基本原理说明。 系统体系结构文档。 对系统的每一个程序，都有相应的程序体系结构文档。 每个子系统的规范和设计说明书。 程序代码列表。这些列表包括程序注释、用来解释代码中复杂代码段和采用的编码方法等。 描述每个程序怎样验证和验证信息与需求之间关系的验证文档。 维护指导文档，主要描述系统已知的问题、软件支持、硬件支持等信息，以便维护时使用。 10.2 项目文档的质量 10.2.1 项目文档结构 10.2.2 文档标准 10.2.3 文档书写风格 10.2.1 项目文档结构 10.2.2 文档标准 过程标准：这种标准定义了高质量文档应该遵守的过程。 产品标准：这种标准操纵文档本身。 交互标准：通过电子邮件和文档数据库交换文档变得越来越重要，交互标准使得所有的文档都存在可比性。 10.2.2 文档标准 10.2.3 文档书写风格 运用主动的而不是被动的语气。 运用正确的术语和语法结构。 句子不宜过长，尽量用短句。 段落简短。 用词简洁，不要长篇累犊。 简明定义用到的专业术语。 应用标题和子标题。 尽可能地逐条列举事实。 不要单纯地参考数字、图、表来理解信息，应当有一定的说明和注释。 10.3 项目文档准备 文档制作：文字处理器、文本格式器、表格和公式编辑器、绘图工具包等。 文档修改：拼写检查器和风格检查器。 文档产品发布：桌面发布包、技术工作包等。 10.3 项目文档准备 10.4 主要项目文档 10.4.1 项目开发立项报告 10.4.2 可行性研究报告 10.4.3 项目开发计划报告 10.4.4 项目分析报告 10.4.5 项目设计报告 10.4.6 程序设计报告 10.4.7 项目测试报告 10.4.8 项目使用与维护手册 10.4.9 项目评价报告 10.4.10 项目开发总结报告 10.4.1 项目开发立项报告 (1) 概述：概述现行系统的组织结构、功能、业务流程以及存在的主要问题。 (2) 新系统的目标：开发新系统的意义和新系统实现后的功能、技术指标、安全和保密性、新系统运行环境等。 (3) 经费预测和经费来源。 (4) 项目进度和完成期限。 (5) 验收标准和方法。 (6) 移交的文档资料。 (7) 开始可行性研究的组织队伍、机构与预算。 (8) 其他需要说明的有关问题。 10.4.2 可行性研究报告 (1) 系统概述。 (2) 新系统的目标、要求和约束。 (3) 可行性研究的基本准则。 (4) 现行系统描述及现行系统存在的主要问题。 (5) 新系统对现行系统的影响。 (6) 投资与效益分析。 (7) 其他可选方案及国内外同类方案的比较。 (8) 有关建议。 10.4.3 项目开发计划报告 (1)概述：主要包括系统开发的主要目标、基本方针