关项目文档规范思考
摘
软件开发程中常听说：某某项目文档相规范某某项目文档相规范项目文档规范常见现象什呢造成项目文档规范原什呢文介绍A项目文档检查情况位资源QA检查结果进行反思总结项目文档规范常见现象分析中原
案例背景
A项目项目群涉电子政务某方面业务项目约20子项目6支开发团队子项目提供开发维护工作该项目具两特点：(1)子项目数量较根合事数量计算子项目约二十项目规模两三(2)A项目周期长1999年启动8年子项目周期短般年时间甚年者半年
加强项目文档规范项目理QA提出求三月时间中6子项目文档进行严格检查发现致性问题求项目理合格项时进行整改QA检查文档程中发现文档编号名称规范版记录较混乱文档体容意剪裁标准文档模板张冠李戴该写文档没写文档没进行流转审批等问题
案例分析
通次集中检查反馈出问题QA思考项目文档规范问题常见现象呢造成情况原什呢
项目规范分活动规范文档规范项目质量分程质量产品质量互相呼应工作方式方法否符合标准流程求介质文档否符合标准模板求然软件项目活动程中软件项目工程活动相规范项目文档规范相严重引起思考：
文档规范常见现象
软件开发程中公司质量体系项目质量求文档规范相公司质量标准项目质量求紧密相连项目文档规范常见现象：
Ø 1项目编号项目命名规范
项目编号时项目甚编号：某项目编号时YKSX时YKSX(TL)
项目名称项目名称包括：项目简称项目全称：简称时命名XX工程项目时命名XX信息系统全称时命名海市XX信息理系统时命名XX工程项目信息理系统
项目编号项目名称(项目简称项目全称)项目统编号简称全称
Ø 2文档编号文档命名规范
份文档编号某项目文档编号WD_PA_PRO_YYMMDD_姓名拼写组成中WD表示公司名称PA表示项目编号PRO表示文档类型处指项目程书YYMMDD表示日期姓名拼写表示姓名拼音三字母组成足三位补XY程中知道PA表示项目编号日期格式写成YYYYMM_DD意增加容文档命名通常编号文档类型名称组成项目程书文档规范命名WD_PA_PRO_YYMMDD_姓名拼写 项目程书
Ø 3文档页眉页脚规范
般正规文档页眉页脚公司Logo公司简称公司标志说明份文档仅代表项目组代表公司形象页眉页脚logo标志应该固定项目组应该意性修改
Ø 4文档版标识规范
根配置理定义文档控制级中低文档需进行版控制时性次性中间性文档文档控制级较高文档进行版理控制
级文档中：户需求说明书概设计说明书等修改少次没留版记录文档标识版记录版应份文档户需求说明书V10doc户需求说明书V11doc等样维护文档容易出错
Ø 5文档体裁剪格式规范
标准文档模板相较项目文档体容裁剪规范意性增加删文档目录容：标准模板体容5章项目文档裁剪写3章者写6章增加章容文档格式完全遵循标准文档模板
Ø 6文档审核意见没签名批复
项目文档中部分文档结尾部分相关员签名审批文档流转程中相关干系阅读果没意见意签名文档进行走查验证理重证项目文档质量进行控制重手段然少阅读样文档进行签名批复者口头指出意见邮件回提出问题终结果项目文档身法签名批复没书面形式更没电子签名
Ø 7模板规范
项目阶段阶段产生类型文档基固定需求阶段产生调研报告户需求说明书需求确认书规范命名：试运行试阶段规划指导试运文档质量体系称试运行计划时命名项目实施试运行方案汇总调研容文档户需求说明书项目理时命名户需求调研报告
Ø 8文档位置存放正确
便文档理项目建立文件夹相关文档分放置文件夹
项目建议方案放项目启动目录需求变更单放系统维护目录实放里没错符合规范时利文档间接影响项目
Ø 9该写文档写
开会没会议纪会发言承诺信誓旦旦会忙碌全抛脑沟通交流没备忘录需求变更系统问题没记录问题弄清楚达命令没计划安排工作排脑袋项目活动规范直接影响文档规范没文档
二 文档规范原分析
Ø 缺乏奖惩措施项目文档规范时缺少奖励：口头鼓励通报表扬增加奖金项目文档规范时没相应惩罚措施：通报批评扣奖金外资型IT公司项目实施规范奖惩方案中项目理质量理掌握团队成员奖金分配权项目理团队成员70奖金拥分配权质量理团队成员30奖金拥分配权项目规范时质量理进行权限范围奖惩
Ø 项目文档作认识理解够客户满意系统稳定功健全项目文档作太正系统客户满意度项目文档规范认识理解够软件开发程中信息传递面面沟通系统演示等方式进行交流文档介质交流辅项目文档否规范谓
Ø 项目理项目组成员熟悉规范知道规范文档应该什样子实施程中清楚想办法进行咨询根工作验掌握资源进行项目文档工作
Ø
三 项目文档规范作意义
项目文档程活动终极成果产品系统程文档客户想法终产品桥梁中介文档通俗说项目户需求说明书软件开发项目需求变更单系统问题维护记录单需求变更系统修改证项目文档项目相关信息证验等载体意义广项目组角度出发项目文档规范意义包括：
Ø 通客户审计政府IT项目审计部门果项目文档规范难通客户审计果审计通求返工验收通
Ø 通第三方监理着信息化建设断加强信息监理断深入果项目文档规范通第三方监理类似样包括专家验收第三方测试等
Ø 项目实施规范促进项目文档规范规范活动形成规范工作成果反项目文档规范促进项目实施规范
Ø 项目文档规范开发维护工作奠定良工作基础
Ø 项目文档产品文档意义区产品文档具反复重性项目文档具次性特征
结
Ø 客户文档命名没特求情况应严格公司规范执行仅项目理项目团队理解认识
Ø 项目文档审批流转程中认走形式说走形式倒认走流程走流程规范办事种表现文档流转程中做职工作果流程问题提交流程改进员改进流程放弃样流程改进员错次改进机会时滋长规范办事行
文档香网(httpswwwxiangdangnet)户传
《香当网》用户分享的内容，不代表《香当网》观点或立场，请自行判断内容的真实性和可靠性！
该内容是文档的文本内容，更好的格式请下载文档
摘
软件开发程中常听说：某某项目文档相规范某某项目文档相规范项目文档规范常见现象什呢造成项目文档规范原什呢文介绍A项目文档检查情况位资源QA检查结果进行反思总结项目文档规范常见现象分析中原
案例背景
A项目项目群涉电子政务某方面业务项目约20子项目6支开发团队子项目提供开发维护工作该项目具两特点：(1)子项目数量较根合事数量计算子项目约二十项目规模两三(2)A项目周期长1999年启动8年子项目周期短般年时间甚年者半年
加强项目文档规范项目理QA提出求三月时间中6子项目文档进行严格检查发现致性问题求项目理合格项时进行整改QA检查文档程中发现文档编号名称规范版记录较混乱文档体容意剪裁标准文档模板张冠李戴该写文档没写文档没进行流转审批等问题
案例分析
通次集中检查反馈出问题QA思考项目文档规范问题常见现象呢造成情况原什呢
项目规范分活动规范文档规范项目质量分程质量产品质量互相呼应工作方式方法否符合标准流程求介质文档否符合标准模板求然软件项目活动程中软件项目工程活动相规范项目文档规范相严重引起思考：
文档规范常见现象
软件开发程中公司质量体系项目质量求文档规范相公司质量标准项目质量求紧密相连项目文档规范常见现象：
Ø 1项目编号项目命名规范
项目编号时项目甚编号：某项目编号时YKSX时YKSX(TL)
项目名称项目名称包括：项目简称项目全称：简称时命名XX工程项目时命名XX信息系统全称时命名海市XX信息理系统时命名XX工程项目信息理系统
项目编号项目名称(项目简称项目全称)项目统编号简称全称
Ø 2文档编号文档命名规范
份文档编号某项目文档编号WD_PA_PRO_YYMMDD_姓名拼写组成中WD表示公司名称PA表示项目编号PRO表示文档类型处指项目程书YYMMDD表示日期姓名拼写表示姓名拼音三字母组成足三位补XY程中知道PA表示项目编号日期格式写成YYYYMM_DD意增加容文档命名通常编号文档类型名称组成项目程书文档规范命名WD_PA_PRO_YYMMDD_姓名拼写 项目程书
Ø 3文档页眉页脚规范
般正规文档页眉页脚公司Logo公司简称公司标志说明份文档仅代表项目组代表公司形象页眉页脚logo标志应该固定项目组应该意性修改
Ø 4文档版标识规范
根配置理定义文档控制级中低文档需进行版控制时性次性中间性文档文档控制级较高文档进行版理控制
级文档中：户需求说明书概设计说明书等修改少次没留版记录文档标识版记录版应份文档户需求说明书V10doc户需求说明书V11doc等样维护文档容易出错
Ø 5文档体裁剪格式规范
标准文档模板相较项目文档体容裁剪规范意性增加删文档目录容：标准模板体容5章项目文档裁剪写3章者写6章增加章容文档格式完全遵循标准文档模板
Ø 6文档审核意见没签名批复
项目文档中部分文档结尾部分相关员签名审批文档流转程中相关干系阅读果没意见意签名文档进行走查验证理重证项目文档质量进行控制重手段然少阅读样文档进行签名批复者口头指出意见邮件回提出问题终结果项目文档身法签名批复没书面形式更没电子签名
Ø 7模板规范
项目阶段阶段产生类型文档基固定需求阶段产生调研报告户需求说明书需求确认书规范命名：试运行试阶段规划指导试运文档质量体系称试运行计划时命名项目实施试运行方案汇总调研容文档户需求说明书项目理时命名户需求调研报告
Ø 8文档位置存放正确
便文档理项目建立文件夹相关文档分放置文件夹
项目建议方案放项目启动目录需求变更单放系统维护目录实放里没错符合规范时利文档间接影响项目
Ø 9该写文档写
开会没会议纪会发言承诺信誓旦旦会忙碌全抛脑沟通交流没备忘录需求变更系统问题没记录问题弄清楚达命令没计划安排工作排脑袋项目活动规范直接影响文档规范没文档
二 文档规范原分析
Ø 缺乏奖惩措施项目文档规范时缺少奖励：口头鼓励通报表扬增加奖金项目文档规范时没相应惩罚措施：通报批评扣奖金外资型IT公司项目实施规范奖惩方案中项目理质量理掌握团队成员奖金分配权项目理团队成员70奖金拥分配权质量理团队成员30奖金拥分配权项目规范时质量理进行权限范围奖惩
Ø 项目文档作认识理解够客户满意系统稳定功健全项目文档作太正系统客户满意度项目文档规范认识理解够软件开发程中信息传递面面沟通系统演示等方式进行交流文档介质交流辅项目文档否规范谓
Ø 项目理项目组成员熟悉规范知道规范文档应该什样子实施程中清楚想办法进行咨询根工作验掌握资源进行项目文档工作
Ø
三 项目文档规范作意义
项目文档程活动终极成果产品系统程文档客户想法终产品桥梁中介文档通俗说项目户需求说明书软件开发项目需求变更单系统问题维护记录单需求变更系统修改证项目文档项目相关信息证验等载体意义广项目组角度出发项目文档规范意义包括：
Ø 通客户审计政府IT项目审计部门果项目文档规范难通客户审计果审计通求返工验收通
Ø 通第三方监理着信息化建设断加强信息监理断深入果项目文档规范通第三方监理类似样包括专家验收第三方测试等
Ø 项目实施规范促进项目文档规范规范活动形成规范工作成果反项目文档规范促进项目实施规范
Ø 项目文档规范开发维护工作奠定良工作基础
Ø 项目文档产品文档意义区产品文档具反复重性项目文档具次性特征
结
Ø 客户文档命名没特求情况应严格公司规范执行仅项目理项目团队理解认识
Ø 项目文档审批流转程中认走形式说走形式倒认走流程走流程规范办事种表现文档流转程中做职工作果流程问题提交流程改进员改进流程放弃样流程改进员错次改进机会时滋长规范办事行
文档香网(httpswwwxiangdangnet)户传
《香当网》用户分享的内容，不代表《香当网》观点或立场，请自行判断内容的真实性和可靠性！
该内容是文档的文本内容，更好的格式请下载文档