[讨论] 为什么很多程序员讨厌写文档，写个文档也不注重排版跟文法

查看相关话题

김노예

2021-09-08T02:11:50+00:00

团队协作沟通是必要的，文档沟通也是其中一环

面试过程中也很少有人关注

Cqid

写文档给我算kpi吗

Swoops

写文档可以不干别的活吗？

Midnight_Foxx

团队沟通很重要，但不是逼程序员给你们这些啥都不明白的人反复科普的理由

代码是最正确的文档，其次是注释，你们那些排版要求诡异符号体系混乱的文档啥都不是

Zekzies

写文档费时间啊

排版更要时间
随手写自己看还行
给别人看还得重新调整措辞语句
重新整理大纲逻辑

不怕拖进度算工资领导认可就写

gottem

排版?文法?

这是学写代码的还是搞文学的? (比如之前网上的段子，你的代码怎么改了个大小写缩进就不能跑了呢？[s:ac:哭笑])

跟外行解释，基本是所有技术工最讨厌的事了吧，不仅限码农

lecticSurge

不止程序员讨厌，很多人都讨厌[s:ac:汗]
发了模板坚决不用，拿着万年前的旧文档修修改改，字体、格式、排版一团乱，有的水印乱加还很执着非要加。说了八百遍都不会改，在上一家公司每次拿到别的部门(非职能)的文档，绝大多数时候都要重新整理一遍……

HubbaBubba

沟通比文档更重要

alejandro.

代码及必要注释是最有效的文档
除非kpi谁愿意写那些低效的文档，最多从代码和注释生成个接口api那种高效点的文档还能看看
一般的文档，讲个不好听的，从data-ink-ratio来说，就是浪费阅读者的生命

bez

还是因为菜，真正的强者都非常理解以人类语言书面沟通的重要性。例如可以去看下Linus给别人的邮件回复都是怎么写的。

Xomu

老板：
先把功能实现了，文档抽空补.
我内心：
我补你妹，我一天实现的功能，文档都要写大半天，你愿意给我一半的项目周期补文档吗？

——————-分割线——————-

其实我还是愿意写文档的，时间给的够，我能写出花来.

jakeeyyy

费力不讨好的事

Tristifano

因为不算工作量，项目经理给排任务的时候可没考虑你还要花时间写文档

kokerr4

你们的程序员还要写文档？

缺产品吗？我去躺尸[s:ac:哭笑]

Lansor

[img]https://img.nga.178.com/attachments/mon_201910/06/9bQ5-d527KuToS2s-2s.gif[/img]文档沟通效率极低，准确性和全面性也不行，大部分时候只是应付形式的，或者撇清责任的

Resurrection

接口5分钟写注释10分钟
写文档排版30分钟起步

Yamil Angura

工科生都不愿意写文档，不仅仅是程序员。你让机械设计的写个装配说明也是一样的

Pat

领导和我们主要关心的是有多少模块通过了验证，有多少没通过，有多少bug没解

文档没完成，不影响打测试向量啊(反正文档写的再详细，也是以三方画押的会议邮件为准)

文档和bug，老板肯定催的是bug啊

kkerk

[quote][pid=550803019,28545614,1]Reply[/pid] Post by [uid=4718520]hurgebug[/uid] (2021-09-17 10:25):

团队沟通很重要，但不是逼程序员给你们这些啥都不明白的人反复科普的理由

代码是最正确的文档，其次是注释，你们那些排版要求诡异符号体系混乱的文档啥都不是[/quote]没注释，你自己看你5月前写的啥感觉？

𝖃poxy <3

写文档是产品的事，注释写的好就行了。。。
问题是有些人注释写的一坨屎或者不写，这个不能忍[s:ac:哭笑]

返回主页