项目管理资源网

您的位置:项目管理资源网 >> IT通信项目管理

软件项目文档如何管理?

2020/1/22 14:59:29 |  476次阅读 |  来源:网友转载   【已有0条评论】发表评论

在软件开发项目当中,文档管理是必不可少的内容,其必要性无人可以否认,但是,一套“规范”的文档,也经常会让人抓狂,“浪费”很多时间在文档上面。

在经历过许多实际的软件研发项目,和多次的制定组织级软件研发项目规范工作,对于软件研发项目中的文档管理有不少的体会,在软件项目的文档管理中,如何使文档管理更加有效,实际能够折射出许多的管理理念。

  1、保证有效沟通

  文档的主要作用是用于沟通,在所有的软件规划、设计、实现、运行、使用、服务等相关人员之间的信息交换。在文档编写过程中,要求所传递信息做到完整、准确、简洁,特别是要能够适合读者理解。紧紧抓住信息沟通这一核心目的,对于无论是制作文档模板还是编制具体文档,都是很重要的指导思想。记得早年学习过国标的软件工程文档规范,不仅文档很多,而且很多的文档的第一章都是背景介绍,曾经试图按照这种规范来编写文档,第一章写了几行就实在是写不下去了,这确实会令许多的软件开发人员感到抓狂,在今天更加强调响应速度的开发过程要求来说,几乎是无法执行的。因此,在编写文档时,关键就抓住两点:一时明确文档的读者对象,二是站在读者角度把读者希望了解的信息完整、准确、简洁的描述清楚。写文档和读文档,就如同是作者与读者之间在对话,把要传递的内容描述清楚,文档的目的就达到了。啰里啰嗦的无关内容,不仅浪费作者和读者的时间,也会影响对文档重要信息的突出。

  2、与所采用的工程方法相匹配

  在软件研发方面有许多不同的工程方法,瀑布式、原型法、敏捷开发等等,不同的开发过程实际意味着不同的生产工艺,那么在不同的工艺方法中各道工序的工作内容和要求不同、工序之间的衔接要求不同,必然也会对文档的要求产生不同。因此,在编写文档时,也需要考虑开发项目中所采用的工程方法的因素,在单位制定软件开发文档模板时,也需要考虑不同的文档体系,以支持不同的开发过程方法。

3、满足产品生命周期管理的需要

  就产品文档而言,有的文档可以是增量式的,只说明某一个版本的具体情况,而有的文档则需要是全量式的,需要随着新版本的发布而不断更新,保持与最新版本相一致,最典型的例子就是用户手册,通常都要随着版本的更新不断进行同步更新,对应旧版本的用户手册已经没有实用价值。另外像产品使用的FAQ这类文档,也是需要不断加以补充、更新,并且以全量版本的方式发布。同时,像系统技术架构、数据结构、发生变更的代码等,这些其实也需要维护全量的最新版本,才能有效支持后续版本的设计开发的需要。因此在文档管理中,也需要对文档进一步细分,同时满足产品版本升级项目过程的需要,和产品生命周期持续发展以及最终交付使用及服务支持的需要。

  4、区分文档的记录与整理

  很多很多的人对于文档都很头疼,需要花费很多“额外”的时间来编写,但实际上我们看到,许多需要在文档记载的实质内容其实并不缺少,在软件研发的项目过程中,该讨论、该沟通的内容实质并不少。对此稍作区分可以看出,问题出在“整理”文档上。所以在实践中,可以将文档的形成分成两个阶段,一是在过程中形成的记录,这些记录可以是手画的草图拍成照片,可以是简单的会议记录,也可以是工具软件本身生成的特殊格式的输出文件,比如数据库设计文档、项目计划文档,这些专业工具形成的特殊格式的文件,其实比转换成EXCEL或PDF文档要好用,而且能够真正在后续的执行中继续发挥作用。能反映实质内容的这些记录形式,其实也是文档!在项目进程告一段落后,再对这些原始的记录进

    项目经理胜任力免费测评PMQ上线啦!快来测测你排多少名吧~

    http://www.leadge.com/pmqhd/index.html

“项目管理生根计划”
企业项目经理能力培养和落地发展方案下载>>

分享道


网站文章版权归原作者所有,如有认为侵权请联系我们,将于1个工作日内作出处理!
网友评论【 发表评论 0条 】
网友评论(共0 条评论)..
验证码: 点击刷新

请您注意护互联网安全的决定》及中华人民共和国其他各项有关法律法规或间接导致的民事或刑事法律责任
·您在项目管理资源网新闻评论发表的作品,项目管理资源网有权在网站内保留、转载、引用或者删除
·参与本评论即表明您已经阅读并接受上述条款