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

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

新入职小白

5分钟前:

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

中级码农

4分钟前:

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

老油条程序猿

3分钟前:

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

开发文档现状

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

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

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

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

少年程序猿

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

讨厌的PM

5分钟前:

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

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

大大大大CTO1分钟前

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

忙成狗的程序猿4天前

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

忙成狗的程序猿1分钟前

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


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

1、没时间写

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

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

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

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

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

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

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

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

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

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

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

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

·END·

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

程序猿为什么不喜欢写文档?相关推荐

  1. 为什么程序员都不写文档?

    ‍‍‍ ‍ [CSDN 编者按]对于程序员来说文档可能是他最大的软肋.一些被称之为高手的程序员,往往是文档方面的处理会偏弱.不管这个程序员是在大公司.还在小公司.不管程序是写文档的.还是不写文档的,大 ...

  2. 程序员都讨厌写文档?这4个工具让你事半功倍

    长按识别上方二维码,关注公众号:后端面试那些事 回复"报告",获取你的GitHub年度报告! 对于一般的程序员来说,花费数小时来创建代码或修改现有代码只是一天工作中的一部分,简而言 ...

  3. 从程序员到项目经理(二十九):怎样写文档

    在软件项目中,文档既是一项的重要成果,也是项目管 理的有力工具.通过文档,可以稳定.明确的传达信息,实现项目内的有效沟通.所以写文档对项目经理来说,是一项必备的技能. 然而很多项目经理害怕写文档,似乎 ...

  4. java开发文档怎么写_程序员该不该写技术文档,怎么写文档,易懂又能提升自己...

    最近公司项目的调用量突然涨了一大波,很多系统都纷纷扛不住了,于是需要对系统进行优化,系统优化的第一步,便是梳理业务! 在这个过程中,经常出现了这样一些情况,发现数据库的某些字段,没有注释,也没有一定的 ...

  5. 程序员写文档的重要性

    写文档的重要性 对于软件相关行业,在学校或单位大家也许都已经注意到了,除了要编写的程序.绘制设计图之外,还有一个重要的工作便是写文档.为什么要写文档呢?因为我们要把自己做的东西展示出来,不光展示给同行 ...

  6. 坚持#第308天~我找到了一种字体非常好,Helvetica,我非常喜欢,写文档专用,昨天晚上加班到1点钟把技术文档写完了,

    字体字体字体: 我非常喜欢这个字体Helvetica,写文档专用的字体,看起来好舒服,记录一下: 这个字体是:文字的是宋体,大小是10.5,非文字的是Helvetica,大小是10.5,记住的方法是: ...

  7. python如何读取公共盘的文档_如何使用 Sphinx 给 Python 代码写文档 | Linux 中国

    最好将文档作为开发过程的一部分.Sphinx 加上 Tox,让文档可以轻松书写,并且外观漂亮.-- Moshe Zadka Python 代码可以在源码中包含文档.这种方式默认依靠 docstring ...

  8. python代码_如何使用 Sphinx 给 Python 代码写文档

    最好将文档作为开发过程的一部分.Sphinx 加上 Tox,让文档可以轻松书写,并且外观漂亮.-- Moshe Zadka(作者) Python 代码可以在源码中包含文档.这种方式默认依靠 docst ...

  9. 泥瓦匠:程序猿为啥要坚持写原创技术博客?

    世界上最廉价的原创是什么?答案希望你从这篇文章中找到. 一.前言 当几年前,接触博客这个词,还是从学长那边.因为他说他学技术,喜欢把遇到的问题,总结到博客上.我就寻思着,学着呗,反正不亏.然后我写了第 ...

最新文章

  1. 一个Bug能有多大影响:亏损30亿、致6人死亡、甚至差点毁灭世界...
  2. 150页在线书「几何深度学习」上线:利用对称性和不变性解决机器学习问题
  3. Spark Master启动源码分析
  4. Apollo本地jar包启动方法
  5. RSGAN:对抗模型中的“图灵测试”思想
  6. JAVA面对对象(一)——封装
  7. 实现自己的BeanFactory、AOP以及声明式事务
  8. ducker桌面版更改安装位置_Ubuntu 16.04 安装 Docker和默认存储路径修改
  9. 计算机辅助设计还需要手绘吗,西安电脑如此发达为什么还要学习手绘
  10. (转)你真的会写单例模式吗——Java实现
  11. 【Qt教程】1.9 - Qt5菜单栏、工具栏、状态栏、核心窗口、浮动窗口、QMainWindow
  12. Graphviz安装配置教程(图文详解)
  13. python变量及其作用域,闭包
  14. ML/DL-复习笔记【五】- 基于梯度的优化方法
  15. python执行shell脚本报错_详解python执行shell脚本创建用户及相关操作
  16. SQL Server安装和修改身份验证方式
  17. Arduino Nano开发板设备描述符无法识别等问题汇总
  18. LintCode 183.木材加工
  19. T语言与快速开发平台之天宇联Android开发手册
  20. 静态成员与非静态成员的区别

热门文章

  1. 分享大型Java多用户商城系统开发历程
  2. 如何利用数据挖掘告别单身
  3. Windows 10新正式版17134.137
  4. 原装应广单片机 MCU芯片PMS152 SOP8封装 单片机开发
  5. 网络安全学习篇28_阶段一小结篇_木马的原理及木马防范
  6. 文化产业新兴产物:游戏音乐外包
  7. 过滤三角网算法求取凹包(二)
  8. python opencv生成钢琴键与五线谱的对照图
  9. 『转』卡巴斯基2014 安装使用小技巧
  10. 在电脑上找不到sql服务器,win8系统安装sql server软件后找不到怎么办