软件开发人员为什么不愿意写文档

bbbian

软件开发人员不愿意写文档，我想这主要指的是刚参加工作时间不长的工作人员。真正的老鸟是不会这样的。我说说自己的看法，希望大家讨论。
1软件开发的大环境不好，
软件开发行业在中国的兴起也就是十几年的事情，国外的软件开发比中国长，但也有限，与中国不同是，国外企业很重视质量管理，过程控制。国外的软件发展受其他行业的影响比较深，基本上是两个思路，一个是美国为主，他们不断针对开发中的问题形成新的开发方法，比如psp，tsp，rup，iso，cmm/cmmi等过程对规范软件开发流程起了很大的作用，而日本和印度基本走的是另外一条路。比如日本开发基本是瀑布型，但每一个步骤都极为细致，以此达到对软件质量的控制，印度基本是cmm，其思路和日本查不多，但不论是美国，日本，还是印度在这些过程控制过程中都强调，计划-执行-检查-调整，而这些都需要文档的支持，所以相对来说，他们的大环境比中国好的多。反观中国，从文化上来说，中国的文化阶层历来喜欢务虚而不务实，大家在讨论的时候都侃侃而谈，但一旦想落实纸面上就没有人愿意干了。这也表现在到现在为止，还没有听说中国出过软件开发大师级人物。而软件行业前一段时间还被称为高科技，这一方面也造成了开发人员浮躁的心态。
2重技巧的学习，而轻视能力的培养。
中国的软件开发人员重视对技巧的学习，比如我们的一个项目负责人，对ie的cookie很熟悉，也很愿意在他的组员面前显示他的才能，可是他连基本的编程规范都不了解，而对调研的方式方法，项目管理的范围定义，时间管理，风险管理，质量管理更是一窍不通，这样的项目经理怎么可能写出好的文档，而他的团队又怎么可能写出完善的文档。
3重视表面的东西，轻视基础。
建设在沙地上的万丈高楼怎么可能不危险，举一个例子，在过去做面向过程的系统开发的时候，有几个人会画标准的数据流图，在作数据库设计的人员中，有几个人讲的清楚1NF，2NF，3NF，BCNF，在面向对象的设计中有几个人可以画出标准的9种类型的设计图。这些东西我们在学校里都学习过，请大家想想我们有几个人真正使用过，而用拍脑门出来的设计，能不出问题吗？
4对系统不了解，是不愿意写文档的最主要的原因
调研人员自认为对客户流程很了解，让他讲解的时候看起来也是头头是道，但他们为什么不愿意写，其实在就是因为他们对客户的流程并没有作到真实的了解。在讨论的时候，如果没有文档，他讲过的话其他人员很难在短时间内理解并且进行检查（听别人说话最好也只能吸收10%的东西），而如果是写成文档，别人看，很多问题就可以发现（看东西可以吸收20%的东西），而且看的时间会比较长，如果是一个比较认真的人还会前后对照，这样很多问题自然会暴露出来。所以避免被别人发现问题方法就是不写文档，这样即使出问题了，也是死无对证，而一旦留有文字资料，你就跑不了。
开发人员其实也差不多，我们的高级程序员，程序员都崇尚于谈论这个体系，那个体系，但作JAVA的有几个可以讲明白J2EE，EJB的，又有几个阅读过tomcat的源代码。这些都不说，你们对JAVA的类库了解多少，知道多少类，他们内部变量的类型，作用是什么，他们的成员函数的功能，输入输出是什么，你也许会说，这些东西还要记忆吗？我们有手册可以查。没错，但学习英语的时候你能只学语法，不学习单词吗？我的原来一个头是做汇编的，他老人家可以随口说出多少号中断是做什么用的，AX。BX。CX。DX都应该是什么值。不下这个功夫，你想写出好的详细设计简直是痴人说梦。而我们现在的开发人员有几个可以做到，对开发环境不了解，是我们开发人员最大的问题，为了掩盖自己的不足，最好的方法当然是不写文档，避免暴露自己的不足。
5有经验的开发人员的流失造成我们的开发低水平循环。经验无法继承。
俗话说吃一堑长一智，国外的软件流程管理，质量管理大家都是年龄很大的人了。但我们的社会却很少愿意容纳我们自己的有经验的开发人员。如果你到各个招聘网站看一下就会发现，现在招技术人员，都要35以下的，也就是说，35以后要不你就在一个地方呆着，要不你就转行。而在几年前更夸张，30就一个坎，30岁是一个什么概念，举一个例子，研究生毕业一般是25岁，做2-3个项目（大项目一般是1年以上的），无论成果还是失败，你刚有了一些经验，好你已经快30了，你面临是是否还能否在这个行业干下去的问题，而这个时候往往是你开始发现问题，开始琢磨改进方法的时候（也是你开始想开始写文档的时候），但人生的选择使你不得不放弃改进工作的方法，（真正了解文档的作用的人都是那些干过很多项目，有很多失败教训的“老”开发人员）。于是你要走了，而新人总是高估自己，于是就向飞蛾一样扑向烈火（糟糕的开发方法，也包括对文档的轻视）
6不会讲问题分层次，复杂问题讲不清楚，是开发人员不写文档的另外一个原因。
中国的开发人员有一个特点就是都是希望成为好工匠（其实好工匠都谈不上），而不想做专业人员。如果一个问题原来处理过，最起码看别人处理过，那么心里就觉得比较放心，但如果遇到一个全新的问题，有没有人咨询，就不知道如何下手了，说简单一点就是没有学会处理问题的方法，不会将复杂问题分层次，不会将问题分解为简单问题，逐个处理。所以在写文档的时候就不知道该写文档，一个问题的一个表现就是大家都热衷于向朋友们寻求各种系统的文档，好自己照猫画虎，而如果找不到类似的文档，就不知道怎么办了。
7糟糕的写作功底，是不写文档的一个原因
我们是学理工，文字功力差一点没有关系，这是很多软件人员的说法，别开玩笑了，很多开发人员不写文档，一个原因就是他们的文档说的根本不是中国话，不要说同音同义字的错误，就连基本的语法都不对，写得需求不要说用户看不明白，我们自己看都不明白，如果让他自己朗读一遍，那恐怕比周星星的电影还要无理头，这种文档开发人员自然不愿意写。
8最后一个原因----没有吃过糖，不知道甜是什么滋味。
这是一个很实在有很尴尬的现实，很多人没有进行过正规的开发，甚至没有见过真正‘好’的技术文档，自然就不能感受好文档的作用，于是认为现在这种糟糕的文档就是最好的，而这些文档对开发没有任何作用（反而耽误时间），自然就不愿意在写文档了

uyul

楼上说开发人员要写的文档具体包括什么文档呢？

swallow0918

开发人员需要写些什么文档呢？

gs6431

需求规格说明书
概要设计规格说明书
详细设计规格说明书
用户使用手册
这些好象都需要开发人员来写吧？！
开发人员并不是指写代码的人员。

luoyear

１、写文档的目的是什么？
２、写出来谁去用它？
３、为什么需要文档？有没有更适合的方法呢？〔如代码加适当的注释体现概要和详细设计的思想〕

gantleman

软件公司好象也没有几个干的长的,项目干完就闪人要文档做什么,难道指望有人拿他做售后.而且软件用什么系统接口也不是程序员说了算的,win系统有上万个api难道都背下来...30岁是个伪命题,目前好的30岁左右的程序员基本都过度到了经理的级别,并且国内的好的程序员本来就少加上技术淘汰的很快所以30岁以上程序员因为无精力和时间学习新技术而很难生存而已.加之国内稳定的软件公司很少,开公司或多或少都本着急功近利的思想去搞,搞到最后不乱都难.

[ 本帖最后由 gantleman 于 2006-4-13 09:43 编辑 ]

qch

sdlkfj3非常同意楼上的观点，一个长久的公司、一个想把公司做大的公司，一定会注意文档的编写工作，没有文档保存将来客户需要维护和升级本公司提供的软件时将会遇到意想不到的麻烦，还是平时做好的好。

monkey2

首先文档的齐全是非常有必要的, 假如说一个公司做一个很大的系统,持续的时间很长,并且没个模块非常复杂, 那但靠几行注释是没什么大用处的, 在加上开发中遇到的风险, 如离职, 加入新员工, 或者在某些细节实现上发生偏差等. 再次就是文档齐全不代表文档的有效性, 如我开发的已经是VERSION 1.1, 而文档还是停留在VERSION 0.3 上, 那这个文档已经失去了它的有效性, 所以还要同步更新.

fxlizard

文档的目的是保留 产品设计的过程...
程序员....我们将他们叫 coding, 注重的是产品的结果... code.

如果程序员 注重了设计... ok,他就应该先学会写设计文档.... 很简单的道理!

liz

赞同版主的观点，但中国程序员首先考虑的是MONEY，大家都想做个两年跳槽；还有中国正规的软件公司很少，每个投资人都想尽快见利润，也导致了这种问题的恶性循环。还是那句话，把想法付诸实践，路漫漫其修远兮！

sunnyl

国内程序员最怕的就是接手别人的工作，在费劲地看着别人的代码，抱怨前人没有文档的时候，往往忘了自己也没有文档。其实国外亦如此，从许多开源组织在提供优秀的代码的同时，却没有几份像样的文档就可见一斑。人都是有惰性的，缺乏责任与约束，才是造成这一问题的根本。而这种责任与约束，应来自于企业和组织。说到底，还是要看企业有没有这个意识。

guyu_susa

1。你怎么知道你要做什么
2。你怎么知道别人要做什么
3。别人怎么知道你要做什么
4。第三方怎么知道你们要做什么
5。你们怎么知道你们最后做了该做的东西。
也或者：
1。你打算做到哪里算哪里
2。你不关心别人要做什么
3。别人不关心你要做什么
4。第三方不关心你们要做什么
5。你们不在乎最后做出来的东西到底是什么。

April.H.X

我觉得项目工期紧迫也是个很大原因～

jut984907

首先，还是要了解文档的必要性。
否则无法得到重视。

zeehom

说得对！
文档相当重要！

jiuyuetian

原帖由 sunnyl 于 2006-8-24 18:07 发表
国内程序员最怕的就是接手别人的工作，在费劲地看着别人的代码，抱怨前人没有文档的时候，往往忘了自己也没有文档。其实国外亦如此，从许多开源组织在提供优秀的代码的同时，却没有几份像样的文档就可见一斑。人 ...

我非常赞同这个观点啊，只是要想彻底改变现状不是一两个人的努力能实现的，靠的是整个的行业啊。

高山来客

说得对！
文档相当重要！

hotivy

10F 个人严重反对你的观点
  不是中国程序员首先考虑MONEY，而是中国老板首先考虑MONEY，有几个国内公司会有正规的培训和福利待遇？？不说了，多说无益

SpiderMan

关于这个主题 ，我先来提一个问题给大家，请大家先思考一下

软件开发过程中，文档的意义是什么，你认为有哪些方面？

冰美

没有文档的结果往往使下一个流程的人受害:测试人员