做为项目组的人员比较关心一下几个问题:
- 按照CMMI3的标准,项目组要提交到SVN的文件清单(识别配置项)。
- 每个文件的命名规范,比如:封面和修改记录中的版本命名规则。在SVN库中应该如何使用?
- 到底是《XXXX项目用户需求说明书v0.2》还是《XXXX项目_用户需求说明书V0.2》?
- 文档传到SVN库中,到底是《XXXX项目用户需求说明书V0.1》还是《XXXX项目用户需求说明书》?
- 一个500页的《概要设计说明书》,能不能拆成若干模块进行撰写?如果可以拆成不同模块撰写,那么如何命名?比如《概要设计说明书_模块1》;如果拆分成了不同的模块撰写,设计基线应该包括哪些内容?
- 项目配置库的命名要求是什么?中文命名、英文首字母缩写、拼音首字母缩写?如果第三方自己管理配置库,而且使用了旧的配置库,那么应该如何管理?是否要建立单独的统一配置库?
- 有哪些基线?基线是如何命名的?不同的产品有不同的基线,如何保持各个产品集成时,版本能够保持一致?
- 配置库的地址是什么?配置库的目录结构和人员权限是怎么样的?
- 项目有哪些基线?每个基线命名规则是什么?什么时候应该打基线?打完基线怎么通知项目组?
- 配置审计什么时候做?多久做一次比较合适?发现的问题应该怎么处理?
- 需求变更,如果引起了项目进度、成本变更应该如何处理项目计划?
- 测试阶段需求变更,如果引起了需求规格说明书的变更、设计说明书的变更、代码变更,应该如何处理?
- 版本发布应该如何操作?比如:多久发布一次?项目组发布程序,应该有哪些配套的文档做运维?版本的命名规则和方法是什么样子的?发布以后应该通知谁?
- 体系文件因为不停的修订,如何保证每个EPG成员及时修改了自己的版本?如何保证各个参与体系建设的人员都知道体系文件的版本发生了修订和变更?如何发布基线版本?
- 不同的项目组先后拿到的是体系文件不同的基线版本,应该如何保持体系文件的版本不混乱?最新版可用,还是使用最稳定的版本?如何保证QA检查时,项目组使用的不同版本的模板都可以通过检查?
适用前提 | 文档类型 | 命名方式 | 适用文档 | 示例 | 说明 |
1.产品在研发过程中有分多个版本迭代开发,并且产品命名有唯一的标识。 2.软件产品不是系列产品中的一员,有能够区别于系列产品的唯一英文缩写或简称。 3.产品有多版本的情况但是建立了文档版本与产品版本映射的追踪矩阵进行配置管理。 | 版本变化型文档 | 提交SVN时记录版本信息 项目名称或编号+文档功能名称+V1.0 (主版本+里程碑版本) | 项目总体计划 | XXX_项目总体计划V1.0.doc | 1.文档入SVN配置库时,使用提交的备注功能标注版本号。 2.对于电子文档,还要在文档的修订记录中体现。 3.两个版本号应该一致。 4.要想查找某个版本的文档了,只要通过SVN中的备注信息就可以方便定位。 5.不提倡在文档名中体现版本号,如:需求报告1.1、需求报告1.2等。否则SVN中将保存多个类似的文档,不便于文档的查找和使用,也会占用大量的资源 |
配置管理计划 | |||||
质量保证计划 | |||||
项目进度计划 | |||||
用户需求规格说明书 | XXX_用户需求规格说明书V1.0.doc | ||||
产品需求规格说明书 | |||||
概要设计说明书 | |||||
数据库设计说明书 | |||||
详细设计说明书 | |||||
用户操作、维护手册 | |||||
测试用例 | |||||
时间区别型文档 | 文档名称有明确的含义,需要用时间标识的日常性文档。 项目名称或编号+文档名称+撰写时间 | 周例会会议纪要 | XXX_周例会会议纪要20130901.doc | ||
评审报告 | 10月9日召开的项目总体方案评审 命名为:XXX_总体方案评审报告20130910.doc | ||||
项目月计划 | |||||
项目月总结 | |||||
阶段性计划 | |||||
更变申请表 | |||||
时间序号型文档 | 多人同时提交同一份文件时,可以在标识的后面加入人名拼音缩写来区别。 项目名称或编号+文档名称 +撰写时间+人名拼音缩写 | 系统测试报告 | XXX_系统测试报告_ 20140812_huxian.doc XXX_系统测试报告_ 20140812_wangling.doc | ||
项目周报 | XXX_项目周报_ 20140812_huxian.doc XXX_项目周报_ 20140812_wangling.doc | ||||
多人一天多次提交同一性质的文件(文件的内容不同),可以在标识上同时加入序列号和人名拼音缩写来区别。 项目名称或编号+文档名称 +撰写时间+序列号+人名拼音缩写 | 单元测试报告 | XXX_单元测试报告_20140812_01_wangling.doc XXX_单元测试报告_20140812_02_wangling.doc XXXX_系统测试报告_20140812_01_xiaolei.doc XXX_系统测试报告_20140812_02_leixiao.doc |
产品文档基线清单 | ||||
分类 | 文档名称 | 命名规则 | 适用范围 | 撰写人员 |
工程类 | 需求说明书 | XXXlabel_需求说明书V1.0 | 内部使用 | 市场,研发,测试 |
概要设计说明书 | XXXlabel_概要设计说明书V1.0 | 内部使用 | 研发 | |
详细设计说明书 | XXXlabel_详细设计说明书V1.0 | 内部使用 | 研发 | |
数据库设计说明书 | XXXlabel_数据库设计说明书V1.0 | 内部使用 | 研发 | |
测试用例 | XXXlabel_测试用例V1.0 | 内部使用 | 测试 | |
测试报告 | XXXlabel_测试报告V1.0 | 内部使用 | 测试 | |
维护类 | 基线功能表 | XXXlabel_基线功能表V1.0 | 内部使用 | 研发,测试 |
产品更新表 | XXXlabel_产品更新表V1.0 | 内部使用 | 研发,测试 | |
产品遗留bug清单 | XXXlabel_产品遗留bug清单V1.0 | 内部使用 | 测试 | |
安装部署手册(研发) | XXXlabel_安装部署手册V1.0 | 内部使用 | 测试 | |
用户手册(用户部署安装使用) | XXXlabel_用户手册V1.0 | 外部使用 | 测试 | |
操作手册 | XXXlabel_操作手册V1.0 | 内部使用,外部使用 | 测试 | |
维护计划 | XXXlabel_维护计划V1.0 | 内部使用,裁剪内容外部使用 | ||
配置管理类 | 版本配置清单 | XXXlabel_版本配置清单 | 内部使用 | 测试 |
产品库目录结构 | |||
SVN库名 | 一级目录 | 二级目录 | 存放工作产品示例 |
项目字母简称 | xxx产品 | 产品文档基线1.0 | XXXlabel_需求说明书V1.0 |
XXXlabel_概要设计说明书V1.0 | |||
XXXlabel_详细设计说明书V1.0 | |||
XXXlabel_数据库设计说明书V1.0 | |||
XXXlabel_测试用例V1.0 | |||
XXXlabel_测试报告V1.0 | |||
XXXlabel_基线功能表V1.0 | |||
XXXlabel_产品更新表V1.0 | |||
XXXlabel_产品遗留bug清单V1.0 | |||
XXXlabel_安装部署手册V1.0 | |||
XXXlabel_用户手册V1.0 | |||
XXXlabel_操作手册V1.0 | |||
XXXlabel_维护计划V1.0 | |||
产品文档基线1.1 | XXXlabel_需求说明书V1.0 | ||
XXXlabel_概要设计说明书V1.1 | |||
XXXlabel_详细设计说明书V1.1 | |||
XXXlabel_数据库设计说明书V1.1 | |||
XXXlabel_测试用例V1.1 | |||
XXXlabel_测试报告V1.1 | |||
XXXlabel_基线功能表V1.1 | |||
XXXlabel_产品更新表V1.1 | |||
XXXlabel_产品遗留bug清单V1.1 | |||
XXXlabel_安装部署手册V1.0 | |||
XXXlabel_用户手册V1.0 | |||
XXXlabel_操作手册V1.0 | |||
XXXlabel_维护计划V1.0 | |||
版本配置清单 |