命名规程
文档编号:FHI_CMMI_CM_PRD_NAME 文档信息:命名规程 文档名称:命名规程 文档类别:CMMI规程 密 级:内部秘密 版本信息:1.1 建立日期:2016-1-13
创 建 人:EPG 批 准 人:李庆林 批准日期:2016-2-25
存放位置:集成公司组织资产库/组织标准过程 编辑软件:Microsoft Office 2003 中文版
1/8
文档修订记录
版本编号或者更改记录编号 V1.0 V1.1 变化状态 C M 简要说明(变更内容和变更范围) 创建 文档编号去掉版本号 日期 2016-1-13 2016-4-17 变更人 张娜娜 邓沛沛 批准日期 批准人 2016-2-25 李庆林 2016-4-17 李庆林 *变化状态:C――创建,A——增加,M——修改,D——删除
2/8
目 录
1
简介 ............................................................................ 4 1.1 文档目的 ................................................................... 4 1.2 适用范围 ................................................................... 4 2
文档名命名规则 .................................................................. 4 2.1 文档的命名的一般规则 ....................................................... 4 2.2 源码模块的命名 ............................................................. 5 3
模板的使用 ...................................................................... 5 3.1 文件位置 ................................................................... 5 3.2 项目文档命名 ............................................................... 6 3.3 项目文档封面修改要求 ....................................................... 6 3.4 项目文档修订记录修改要求 ................................................... 7 3.5 使用EXCEL模板,与上面说明同。 ............................................. 8
3/8
1 简介
1.1 文档目的
本文的目的是描述在项目软件管理过程的配置管理活动中如何对文件夹进行命名以及识别和标识配置项。
1.2 适用范围
本文档的适用范围为组织中的各软件项目。
2 文档名命名规则
2.1 文档的命名的一般规则
命名规则:使用中文命名,这个文件名表达了编写该文档的意图,前缀为项目简称,如:大学学院管理系统配置管理计划.doc。
使用公司组织标准过程模板,项目文档的命名见本文3.2章节说明。
如产生同类文件有多个,可以采取的方式: 1、在文件前缀或后缀增加“日期”以区分:
例如:使用《年度培训计划模板》时,可以定义文档的命名规则为:
YYYY+年度培训计划,其中YYYY为所做培训计划的年度,如2007年度培训计划。
例如:使用《项目周报模板》是,可以定义文档的命名规则为:
项目简称+项目周报+YYYYMMDD-YYYYMMDD,其中第一个YYYYMMDD是本周一的日期,第二个
YYYYMMDD是周六的日期。
2、在文件中或后缀增加项目阶段或工作产品名称以区分:
例如:使用《评审报告模板》时,可以定义文档的命名规则为:
项目简称+评审报告+“-”+工作产品,如济南大学学院管理系统评审报告-系统测试
如果某阶段进行了多次工作产品的评审,可以在后面增加流水号。项目工作产品定义:立项、项目计划、用户需求、需求分析、概要设计、详细设计、设计(如果合并概要和详细设计)、集成测试、系统测试、测试(如果合并集成测试和系统测试)、单元测试、代码、验收等。
3、在文件后缀增加“姓名”以区分:
例如:使用《评审检查表模板》时,可以定义文档的命名规则为:
项目简称+评审检查表+“-”+工作产品+“-”+姓名,如大学学院管理系统审检查表-需求
分析评-张娜娜
4/8
4、在文件后缀增加流水号以区分:
例如:使用《变更请求表模板》时,可以定义文档的命名规则为:
项目简称+变更请求表+流水号,其中流水号从01开始顺序排,如大学学院管理系统变更请
求表01,大学学院管理系统变更请求表02
具体应用时,可以以上几种方式结合使用。
对于模版中没有定义的文件,属于通用性文档的情况,由项目经理向EPG提出改进请求,增加新的模版,属于个性文档的情况,由项目经理与配置管理员协商命名,命名规则应遵循CMMI模版一般的规则。
在进行配置项识别时,对文档进行命名,由配置管理员协助项目经理做此项工作。
2.2 源码模块的命名
模块的命名由项目组参照《编码规范》中的命名原则命名,通常为字符串。 软件产品需根据版本进行打标签。
3 模板的使用
3.1 文件位置
公司过程文件的模板分别保存在每个过程说明子文件夹的“templates”下,例如,点击打开项目监控过程“PMC”下的“templates”,此文件夹下的所有文件,都是项目监控过程域相关的模板。
5/8
3.2 项目文档命名
使用模板时,将模板拷贝到你自己项目文件夹上,重命名文档,增加前缀项目简称,删除后面的“模板”字样。例如:对项目总结报告模板的引用:
模板命名:《项目总结报告模板》
引用在湖北省洪山区政府OA项目上(项目简称:湖北洪山政府OA)项目的项目总结报告文档的命名是:
湖北洪山政府OA项目总结报告.doc
对于在项目过程中可能产生多个文档的模板,除了满足上述说明外,再根据每个文档的编写要求增加对应的前缀或后缀。例如:项目周报的命名。
3.3 项目文档封面修改要求
原则:不允许有空白!
模板提供的封皮格式如下所示:
引用时:
将首行的说明前增加一行,为项目名称;例如“用户需求说明书”模板; “文档编号”将模板中的“TEM”替换为项目编号,其他保留;
6/8
“文档信息”在模板的说明前加【项目名称】,或其他相关的说明;
“文档名称”为项目文档的文件名,一般为在模板的说明前加【项目简称】称; “文档类别”修改为“项目文档”字样;
“版本信息”是你这个文档的版本号,与公司模板无关,按照实际填写; “建立日期”是你这个文档建立的日期,与公司模板无关,按照实际填写;
“密级”根据实际情况填写,非涉密项目一律填“无”,涉密项目根据所定密级填写; 删除“创建人”、“批准人”、“批准日期”、“存放位置”四行,将对你这个文件的修订记录登记到模板第二页。
3.4 项目文档修订记录修改要求
原则:不允许有空白!
模板提供的文件修订记录格式如下所示:
引用时如下:
删除括号中的蓝色字体及括号说明:(引用时请修改为实际项目的信息) 删除模板自带的修订记录;
“版本编号或者更新记录编号”:按照项目文档实际的版本号,注意:此版本号与配置管理工具
的版本号不一样,最新版本与本文档封皮上的版本号一样;
“修改日期”:按照项目文档此行版本的修订日期; “变更人”:按照项目文档此行版本的变更人;
7/8
“批准日期”:按照项目文档此行版本的批准日期,正式评审批准的文档填写评审报告中评审通
过日期,其他评审方式批准的文档填写评审通过日期。
“批准人”:按照项目文档此行版本的批准日期,需求文档、项目策划文档需要技术总监批准,
设计文档、决策分析文档需要部门经理批准,变更文档需要CCB批准,其他文档可以项目经理批准。
3.5 使用EXCEL模板,与上面说明同。 3.6
8/8
因篇幅问题不能全部显示,请点此查看更多更全内容