程序猿为什么不喜欢写文档?

原创 2017年07月12日 09:24:50

公众号文章地址:程序猿为什么不喜欢写文档?


有几个事情其实一直是猿猿们内心的痛:

新入职小白

5分钟前:

这系统怎么就没有文档呢?


中级码农

4分钟前:

这代码tm居然没有注释和说明!!!


老油条程序猿

3分钟前:

让文档见鬼去吧!谁爱写谁写


开发文档现状

问了差不多十几个程序猿同学关于公司文档的现状,基本上只有个别人说公司有很比较严格的文档要求,其他的文档质量和完整度参差不齐。

其实,当我们接触一个老系统的时候,总是希望有健全的文档来支持快速学习。但是,当自己写文档的时候,又不(愿意)好好写,真是本是同根生相煎何太急啊,怎么就不能给以后进来的人留条活路呢……

                                                                                                                 ————《程序员死亡笔记——绝命文档》


程序猿为什么不愿意写文档

少年程序猿

明天就要上线了,今天下午PM说改需求,程序都改不完,让文档见鬼去吧。

讨厌的PM

5分钟前:

经过近一个月项目组成员的加班加点工作,xx系统按时上线,在此感谢各位的付出。

后面,我们将进行一个新系统的开发,各种童鞋收拾好心情,重新投入到新的工作当中,收尾工作不太紧急的,先往后放放。


大大大大CTO1分钟前

今年招聘的员工质量都不错,都是ACM拿奖的同学,编程能力应该都很不错,xx工作室的游戏又要增加收入了


忙成狗的程序猿4天前

     这个系统逻辑比以前复杂很多啊,感觉应该先做个demo试试,然后在写设计文档。


忙成狗的程序猿1分钟前

    代码总算写完了,坑真多,文档后续再补吧




总结一下就是一下几个原因:

1、没时间写

明天上线!需求又改了!代码催得紧!新任务又来了,反正就是各种原因,没时间写了。

2、开发有难度,先做demo,做着做着代码写完了

有时候对于系统的可行性还存在疑问,就想着去做个demo,做着做着,系统程序代码出来了,写文档干啥啊?补文档有啥用,后面再补!

3、领导对于文档的重视程度


多半说的是外包公司,什么时候代码写完,就可以收钱了(或者象征性的补补文档),成本管着呢,代码现行


4、文档对于个人编码能力提升有限

在这个以“能力”定薪水的IT行业,编码能力似乎才是决定程序猿薪水的关键因素,没办法,先提高代码能力吧!代码往后放放。



如何才能改善文档的现状?

从领导开始,自上向下重视文档,项目计划、估算增加给文档分出该有的时间。


严格的文档检查制度,只有文档也作为考核的目标,可能才会重视起来吧,不过,前提是制度对每个人均适用,不能因为是大神就可以制度之外。


招聘制度强调文档的技能要求,让这项技能成为一个明文要求。


要教育好孩子,首先还得自身硬,让老员工做一个好的榜样,让新员工有个学习的目标。自己学习不好,让自己的孩子要好好学习,总会让孩子有叛逆的心理,可能适得其反


·END·


技术,有鸡汤,还有碎碎念,快点扫描关注吧大笑







这么多年终于理解程序员为什么不喜欢写文档的原因

下面是今天在一个文章中看到,终于理解程序员为什么不喜欢写文档的原因。 理由如下: 英文: If it’s not code, it can’t be run through a comp...
  • ITLionWoo
  • ITLionWoo
  • 2014年01月27日 00:30
  • 3018

结对编程,为什么大部分程序猿不喜欢?

我是结合自身以及团队的因素来说明一下感想的,仅供参考。 当我们部门出现要组织大家结对编程的话题时,大家是非常反对的,问题就是担心效率下降了,学习成本增加了,没有自己的 隐私了等等,在IT行业有很大一...
  • wangqjpp
  • wangqjpp
  • 2017年05月22日 17:38
  • 289

为什么这么多人喜欢做饭而不喜欢洗碗?

一、我没有科学数据,只是瞎掰。 二、用e=e(c)来解释。 1、缺乏价值,缺少奖励。 把碗洗得干净,但没有谁会感谢这个洗碗的。吃到好吃的,一下子就知道。但是餐具很干净,吃饭的“不知道”。 2、术。 洗...
  • maqingqing1992
  • maqingqing1992
  • 2016年01月27日 16:10
  • 515

为什么程序猿老是在不停地加班。

.点击上方“程序员大咖”,选择“置顶公众号”关键时刻,第一时间送达!来源于网络,暂未联系到原作者,若大家联系到原作者,可告知程序员大咖。程序员大咖整理发布,转载请联系作者获得授权【点击成为Python...
  • Px01Ih8
  • Px01Ih8
  • 2018年01月09日 00:00
  • 4990

HR最喜欢问程序员的10个问题

HR最喜欢问程序员的10个问题 最近我拜读很多文章,都是介绍面试问题的,我真心不理解,面试官代表公司想要聘用的是最优秀的程序员,那就意味着需要想出一些有意义的面试问题。如果你就提一些毫无用处...
  • huangshulang1234
  • huangshulang1234
  • 2018年01月20日 10:07
  • 59

为什么程序员讨厌写文档

看到一个笑话: 程序员最讨厌写文档,比这个还讨厌的事情就是,别人居然不写文档! 程序员不写文档,可能性主要有两条:第一,不屑于写文档,认为代码胜过文档,代码代表一切! 第二,写不出文档,程序没有...
  • dylloveyou
  • dylloveyou
  • 2017年09月06日 10:52
  • 417

我们为什么写文档?

写文档究竟是为了什么,现在大部分的文档写的都很形式,都是做个样子。很多团队都是先有代码后有设计说明,简直就是笑话。完全的形式主义,为了文档而写文档,完全把文档的意义给扭曲了。 l 文档帮助我们进行更...
  • tanyaliji
  • tanyaliji
  • 2011年09月07日 10:50
  • 295

为什么程序员不愿意写文档

一提到文档,肯定会有人向你大谈外国公司、大公司、正规公司是怎么怎么重视文档的,什么2/3时间用于写文档,1/3时间才用来编程序;写文档要按照什么ISO、什么CMM、什么标准;不按这些标准写出来的就不是...
  • luoyan611
  • luoyan611
  • 2011年06月23日 10:38
  • 162

你写文档吗?你为什么应该写文档?

摘要本文主要是结合作者的项目实践来说明文档对于一个团队开发的重要性, 以及在提高效率节省时间方面的意义, 并且指出如何在实践开发中写文档与维护文档.Contents摘要 引入 为什么要写文档 为什么大...
  • xiaoping8411
  • xiaoping8411
  • 2009年12月07日 09:38
  • 484

为什么老板不喜欢员工解释?

百度搜索:小强测试品牌    微信公众号:测试帮日记    QQ群229390571 我们在工作中是应该以结果为导向,尽量实现一个好的结果,同时相信工作中几乎没有人会故意去制造一个不好的结果...
  • xqtesting
  • xqtesting
  • 2017年02月17日 09:37
  • 326
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:程序猿为什么不喜欢写文档?
举报原因:
原因补充:

(最多只允许输入30个字)