第九章 为什么程序员不愿意写文档.pdfVIP

为什么程序员不愿意写文档？ 一提到文档，肯定会有人向你大谈外国公司、大公司、正规公司是怎么怎么 重视文档的，什么2/3 时间用于写文档，1/3 时间才用来编程序；写文档要按照 什么ISO、什么CMM、什么什么标准；不按这些标准写出来的就不是文档，就不 是好文档。不重视文档就是不正规等等等。当问及他自己写过什么文档，编写过 什么文档标准的时候，这种人就哑口无言了。这种人就是一种媒体一种广告。 不管怎么说，文档绝对是程序员最大的软肋。一些被称之为高手的程序员， 往往是文档方面的低能儿。不管这个程序员是在大公司、还在小公司、不管程序 是写文档的、还是不写文档的，大部分程序员在内心深处中是不愿意写文档的。 天下的怪事特别多，有时让人不能理解。程序员一般不愿意写文档，但是程 序员却喜欢看别人的文档。即使写了文档，程序员一般不会把所有功能都写入文 档，却抱怨别人文档有的功能没有说明。即使写了某段文档，程序员一般不不想 把文档写的很详细，却抱怨别人写的文档不够详细。文档绝对是摆在程序员面前 的一个矛盾，如果让程序员选择是喜欢写文档，还是喜欢看文档，我估计大多数 程序员都会选择后者。 那么程序员为啥不愿意写文档呢？个中原因很多，我自己不妨归纳几点： 1、 怕烦 程序员从入门之日起，就在心里埋藏了一个编程的种子，认为程序员就是编 程序的，就是和计算机打交道的，程序就是程序员的全部。无论是在编程之前要 写文档，还是在编程之后要写文档。他们都认为写文档很烦人。 1）文档种类太多。越是正规越是多。一想到要写那么多的文档程序员 头都要大了。 2 ）文档写作要求不低。有格式要求、有内容要求、还需要画各种流程 图、示意图、关系图、界面图、还需要填写各种表格说明，要收集各 种资料。虽然没有技术含量、但是时间要花的比编程序要多的多呀， 而且也不一定能写好。 3）在正规的开发公司一般一个变更就要编写一系列的变更文档。当变 更不断的时候,只有最后的变更文档是最重要的，当我们不知道当前 是不是最后一个文档的时候，我们就不可能愿意写将被后面替代的文 档。 4 ）当你写了文档后，就会不断有使用文档的人来问这问那，这些询问 往往会让你崩溃。因为，你很难写出让每个人都提不出问题的文档。 2、 没空 在很多情况下，程序员处于一种“时间紧，任务重”状态。在急于看出编程结 果的驱使下，程序员一心扑在编程上，恨不得一分钟一个变化。哪有心思和时间 先把文档写好再去编程呀。即使他们想先把程序编出来，然后补写一下文档想法， 但是一旦他们一个段程序完成之后，就会立即扑向第二段程序的。如此下来，编 写文档只能放在项目开发的后期了。要是你真的写文档，那写文档的时间早已将 编程时间给挤占了，你的编程工作就完不成了。 3、 没有用 文档的重要性其实对不同对象是不一样的。如果你说文档没有用，立即会有 人用吐沫把你淹死，他们立即会搬出那个那个说文档是重要的，文档是不可缺的。 唯独自己不敢说“我认为文档是重要的。”这也反过来说明文档的有用性程度是 不一样的。对于程序员来说，它只要能把程序编出来就行了。很多程序员不写文 档照样编出程序来，在他们观念之中文档不写也罢。如果按文档编程序，那就要 确保文档的正确性、不可更改性。而实际上，文档不如编程快、编程不如变化快， 不断变化的需求和代码让文档如同一张过时的废纸一样。 现实中，有的文档变成了项目开发后的总结，对开发本身并不起作用，只是 保留一个有的形式，以应付各种各样规范的需要。在这种情况下，文档没有任何 实用价值，所以即使程序员写了，也没有什么作用。尤其是项目投产后，几经升 级，最初的文档早已和现实的情况对不上号了，文档更新和系统的一致性更是难 上加难。 4、 没好处 既然认为编程序才是正道，那么程序员就会写文档就是一种额外和辅助的工 作，做了就做了，对于程序员来说没有任何好处。所以没有好处的事是很少人乐 意去做的。 当然文档的好处更多地体现在软件公司、单位、软件用户、后续程序员身上； 它是一种前人栽树后人乘凉好事。但是，现在做好事的人太少了。所以，程序员 不愿意写文档。 文档有多重要？有人把它上升到“程序员头脑的拷贝”的高度。有的人甚至 说，程序员走了后，只要有了文档，软件公