[原创]文档，写还是不写？

文档，写还是不写？

2008-7-22

商蓉蓉

项目管理中的文档到底写还是不写、如何写、写到何种程度的问题，已是老生常谈，支持者认为有利于提高项目的管理水平，反对者认为除了增加工作量外毫无益处。

双方各持己见互不妥协长期胶着的结果就是，文档依然在写，但具体写了些什么、写得怎样、是否达到了管理目标已经无人关心，致使本来可以发挥更大作用的管理手段成为鸡肋。

原因何在？

首先，遭到强烈抵制的文档必定存在不可忽视的硬伤。比如：目的不清、内容重复、表格繁琐，既不易于填写拟制，也不利于信息收集，尽管制定模版的初衷是为了增强项目的管理水平，却往往在执行过程中遭到强大阻力，反而增加了管理的难度和成本。

其次，由于程序员的工作习惯和认识上的原因，也会造成文档管理实施不畅。当然，越来越多的程序员已经认识到了文档工作的重要性，但是事到临头还是会觉得麻烦，因此常常在编写过程中敷衍了事偷工减料，造成文档有量无质，无法达到最初的管理目标，久而久之，管理文档的编写就流于形式，成了鸡肋。

怎样应对？

首先，从文档模版的编制入手

大多数成熟的项目经理，都曾经历过按照顾问的模版照搬照抄的“以它山之石攻玉”的阶段，也曾经历过放弃任何模版全凭自觉的“崇尚自然”的阶段，最后历尽千辛万苦终于修练到了可以信手拈来为我所用的“返璞归真”的阶段。

只有到了“返璞归真”的阶段，才是真正理解了编写文档的作用，才能制定出既符合管理目标，又简单方便实用的模版来，才能让文档管理真正发挥出应有的作用，让文档成为有效的管理工具。

其次，从提高人员的认识入手

程序员千万不要惧怕写文档，也不要拿理科生文笔不好作借口逃避文字工作，要知道，文字也是重要的沟通方式，尤其是在职场，无论是上情下达还是部门沟通都要依靠文件的传递，文字能力是个人能力的一个重要方面。

程序员也要学会换位思考，如果只顾埋头向前冲，再努力也只能是个优秀的马前卒，何时才能有机会升坐中军帐呢？在努力Coding的同时，也应该思考一下为什么经理让我写这些文档，他希望了解什么信息，达到什么目的？如果换成我，会怎样设计这份文档？

对于程序员来说，文档要有目的的写，通过理解文档的编写意图来理解项目经理的管理目的；对于项目经理来说，模版要有针对性的编，通过控制模版的内容设置来全面掌握项目的各种信息，在加强项目控制能力的同时，积累下来项目的历史数据，为今后的项目提供依据和借鉴，提高项目的管理能力。（欢迎与作者交流：shangrr@hotmail.com）

希望每个程序员都能通过认真的“写文档”，尽早的获得“编模版”的机会。