`
studying_
  • 浏览: 170063 次
  • 性别: Icon_minigender_1
  • 来自: 广州
社区版块
存档分类
最新评论

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

阅读更多
软件开发人员不愿意写文档,我想这主要指的是刚参加工作时间不长的工作人员。真正的老鸟是不会这样的。说说自己的看法,希望大家讨论。

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、最后一个原因----没有吃过糖,不知道甜是什么滋味。

这是一个很实在有很尴尬的现实,很多人没有进行过正规的开发,甚至没有见过真正‘好’的技术文档,自然就不能感受好文档的作用,于是认为现在这种糟糕的文档就是最好的,而这些文档对开发没有任何作用(反而耽误时间),自然就不愿意在写文档了。


分享到:
评论
2 楼 lin23871 2009-09-28  
开始学习怎么写文档,多谢多谢
1 楼 lin23871 2009-09-28  
顶。。好文章。
说到我心头去了

相关推荐

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

    《软件开发人员为什么不愿意写文档》 在软件开发领域,文档的重要性不容忽视,它既是项目的蓝图,也是团队间沟通的桥梁。然而,不少初级开发者甚至一些资深开发者常常表现出对编写文档的抵触情绪。这种现象背后的...

    测试人员应对开发人员的几个要点

    总的来说,测试人员与开发人员的关系不应是冲突的,而应是互补的。通过建立互信、合作和有效沟通,两者可以共同提升产品的质量,推动项目的成功。测试人员的角色不仅仅是找出问题,更是促进问题的解决,为整个团队...

    小程序离职交接文档

    6. 知识传递与沟通:文档最后提到了交接文档的目的,是为了让接班人员理解并接手项目的知识点,同时强调了在交接过程中遇到不清楚的问题时应及时沟通,交接人员愿意提供帮助但不负责进行代码教学。 内容【部分内容...

    最齐全的企业开发需求文档

    根据提供的文件信息,我们可以推断出这是一份与企业级软件开发相关的需求文档资源分享。接下来,我们将基于标题、描述及部分可见内容来提取并展开相关的IT知识点。 ### 最齐全的企业开发需求文档 #### 一、文档的...

    公司软件开发人员绩效评价标准.pdf

    主人翁精神则体现为开发人员是否有责任感,是否愿意主动承担工作,为团队的利益着想。协作性则体现在能否与团队成员保持良好的合作关系,主动为团队贡献自己的力量。 综上所述,公司的软件开发人员绩效评价标准旨在...

    撰写文档自动生成框架

    此标题指的是一种能够帮助技术开发人员自动或半自动地生成文档的工具或方法论。这种框架通常包含了预定义的样式、模板以及自动化功能,从而让开发者能够将更多精力集中在业务逻辑和技术实现上,而不是文档的格式和...

    重视文档,彰显大厂风范

    在紧迫的项目进度和繁重的任务面前,编写文档往往被视为额外的负担,导致开发人员更愿意把时间投入到实际的编程工作中。而从长远来看,良好的文档习惯不仅能提高个人的工作效率,也有助于提升整个团队和产品的质量。...

    软件资料文档标准规格

    3.6 局限性:说明现有系统存在的问题以及为什么需要开发新的系统 4 所建议技术可行性分析 4.1 对系统的简要描述 4.2 与现有系统比较的优越性 4.3 处理流程和数据流程 4.4 采用建议系统可能带来的影响  ● 对...

    中国嵌入式开发从业人员调查报告.pdf

    ### 中国嵌入式开发从业人员调查报告解析 #### 嵌入式行业的前景与发展趋势 随着信息技术的飞速发展,嵌入式系统作为连接物理世界与数字世界的关键桥梁,在诸多领域展现出巨大的应用潜力和发展前景。根据《中国...

    focas2开发包

    【描述】中的信息表明,这个Focas2开发包是全面的,包含了所有必要的组件,如接口程序和示例代码,这些都是开发人员理解和应用接口的关键资源。购买这样一套开发包通常需要一定的成本,但分享者愿意将这一资源公开,...

    软件开发日语用语!!!!

    本书为软件开发人员提供了系统学习日语用语的框架,涵盖了例文、词汇、译文、语法、实例和练习六个部分。例文部分挑选了在对日软件开发中出现的典型文档内容,其目的是让学习者掌握这些文档中的专业术语及其表达方式...

    初级软件开发或初级测试人员岗位

    2. **文档编写**:软件开发过程中,编写相关文档是必不可少的,包括需求文档、设计文档、测试文档等。初级开发者应掌握基本的文档编写技巧,能够清晰、准确地表达技术思想。 3. **测试工作**:初级测试人员需要进行...

    开发人员_37_it人员简历_程序员简历模板_计算机相关专业.docx

    这篇文档是一个针对IT专业人士,尤其是开发人员的简历模板,它涵盖了应聘者的个人信息、求职意向、自我评价、奖项荣誉、工作经验和教育经历,同时也强调了掌握的技术技能。以下是简历中的主要知识点: 1. **求职...

    英文版需求文档

    - **作用**:确保所有相关人员都能理解文档内容,避免沟通障碍。 #### 程序与数据库命名规范 - **目的**:统一程序代码及数据库对象的命名规则。 - **作用**:提高代码可读性及维护性。 ### 二、功能需求 #### ...

    2021开发工程技术人员转正工作总结范文.docx

    作者认为,这种文化对工程技术人员的职业素养提升具有积极意义,因为开发人员需要具备高度的责任感和精确性。 2. **产品开发流程**:作者了解了新宝研发中心的标准开发流程,认识到在产品导入初期的成本报价精细化...

    软件开发人员辞职报告范文.doc

    标题中的“软件开发人员辞职报告范文”指的是一个用于软件开发人员向其所在公司提交的辞职信模板。描述中提到的“xx 公司”是该软件开发人员工作的具体单位,而“两年多”的时间表明他在该公司有较长时间的工作经验...

    开发人员_9_网络公司it人员简历_程序员简历模板_计算机相关专业.docx

    【开发人员_9_网络公司IT人员简历_程序员简历模板_计算机相关专业.docx】这份文档是一个典型的IT专业人员的简历,主要展示了高宇(GAO YU)的专业背景、教育经历、工作经历和技能专长。以下是简历中的关键知识点: ...

Global site tag (gtag.js) - Google Analytics