关于软件工程血的教训之文档管理

       文档管理混乱是上个项目最为致命和混乱的,我个人认为,如果一个项目小组进行开发一个系统的时候没有文档的开发个人认为是可怕的,而在系统的开发中没有对文档进行有效管理是恐怖的,我们要做的是一个产品,而不是自娱自乐的一个试验品,作为产品,必须要标准,无论是客户给我们的标准还是开发小组给自己的标准,关于标准将在后面做详细讨论。而有标准就必要有相关的文档,关于文档的好处大家都清除,无论在软件开发部署以及维护的任何阶段它都扮演着很重要的角色,关于文档我觉得它不是形式一个开发小组的负责人对文档的态度就觉得乐这个系统的成败(说的夸张些)。

除了认真做各个阶段的相关文档外,还要对文档进行有效管理,下面将说一下这几年来对文档管理的一些开发,仅仅是抛砖引玉,欢迎大家补充和牌砖。
   1 文档必须需要版本。

像软件一样,如果不对文档进行版本管理和控制,文档的修改将造成文档的混乱,尤其是比较大的项目,一定对文档的管理进行版本控制,不然每次文档修改,想找到什么时候做乐什么修改,为什么做这次的修改都搞不清楚,后面的程序员的工作就很难开展。


2文档需要专人负责。

如果一个小组的人手足够多的话,希望能有一个人来专门负责对文档管理,如果开发小组的人手紧张需小组某一个人简直负责,不能每个人都随意的对所有的文档都拿来拿去。


3文档的修改要有严格的章程控制。

文档一旦形成,不能随意修改,当然形成正式版本的文档之前一定要认真讨论确定文档,一旦文档确定后,不能随意修改,尤其是前期文档,如需求分析,需求分析一变后面的设计文档都要变,这样变来变去会影响到系统的整体进度与软件的质量。每次修改都要做好记录为什么要做这个修改,修改乐哪些部分 会影响到哪些文档一定要注明还要包括文档修改的发起人和批准人。


4 文档的份数。

个人认为一个十人以内的开发小组每个版本的文档只需要一份,尤其是开发阶段流传在程序员手中的文档尽量只有一份,大家以互相传阅的方式进行查阅文档,并不是每个人一份文档会给项目的进度带来有利的影响,上一个项目中每次文档修改后,都给每个人打印一份近千页的文档,一是造成了巨大的浪费,二是由于没有对版本控制好,每个人手里的文档不止一份,开始的时候大家还比较清楚到最后,大家都快搞不清应该以哪一份文档为准了。

今天就先写到这里了,希望大家看后补充 谢谢

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
软件工程常用文档模板及示例:项目计划、需求分析、概要设计、详细设计、用户操作手册、测试计划、测试分析报告、开发进度报告、项目开发总结报告、软件维护手册等。 一、计划阶段 01 项目信息表 项目信息表 - 模板 项目信息表 - 示例 02 项目实施方案-PPT版 项目实施方案 - 模板1 项目实施方案 - 模板2 项目实施方案 - 示例 03 项目实施方案-Word版 项目实施方案 - 模板 项目实施方案 - 示例 04 项目实施进度计划 项目实施进度计划- 模板 项目实施进度计划- 示例 05 项目实施进度简表 项目实施进度简表 - 模板 项目实施进度简表 - 示例 二、需求阶段 需求规格说明书 - 模板 需求规格说明书 - 示例 三、设计阶段 功能设计说明书 - 模板 功能设计说明书 - 示例 数据库设计说明书 - 模板 数据库设计说明书 - 示例 四、开发阶段 系统提测申请单 - 模板 系统提测申请单 - 示例 五、测试阶段 01 测试用例 测试用例表 - 模板 测试用例表 - 示例 02 测试报告 系统测试报告 - 模板 系统测试报告 - 示例 六、验收阶段 01 系统竣工报告 系统竣工报告 - 模板 系统竣工报告 - 示例 02 安装维护手册 安装维护手册 - 模板 安装维护手册 - 示例 03 培训文档 培训文档 - 模板 培训文档 - 示例 04 使用手册 使用手册 - 模板 使用手册 - 示例 七、其他模板 工时统计表 - 模板 工时统计表 - 示例 会议纪要 - 模板 会议纪要 - 示例 项目进度简报 - 模板 项目进度确认单 - 模板 项目进度确认单 - 示例 项目月报 - 模板 项目月报 - 示例 项目周报 - 模板 项目周报 - 示例

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值