精力,看文档的人不知所云,故只有高质量的、必要的文档才是我们所需要的。
既然文档这么重要,一定有人会问:如何写好文档呢?这个就是接下来要谈的问题。
大家在写文档的时候,肯定会为从哪里写起、文档的结构怎么定、具体写哪些内容等发愁,这就需要企业建立起自己的组织过程资产库,提供模板和样例。文档模板规定了该类文档的组织结构、主要内容、模式要求等;样例提供文档编写的范例与参考。当然,文档的模板不是拍脑袋弄出来的,是来源于实际项目,并参考了业界的一些最佳作法,然后到具体项目中使用再修订最后才订搞,后续不断优化改进;样例则是模板在实际产品开发项目中使用的结果。
再就是,组织过程资产库中发布的文档模板是比较全面和系统的,那么在一些实际项目中就会有自己的特点,可能不需要提供项目每个阶段所有的文档,可能编写的文档内容不需要包括文档模板中所有的内容,这种情况可以根据实际情况裁减,提供裁减指南。
随着信息技术的发展,项目中的很大一部分文档通过一些工具和管理系统反映出来,像一些建模工具、项目管理系统、需求管理系统等,但这些都是文档的另一种表现形式,很多编写的工作通过工具和系统自动化处理,从而很大程度上提高的编写文档的速度与质量,同时大大提高了效率。
不管如何,我们要意识到写文档的重要性和必要性,并养成编写好文档的习惯。