63 条回复  ·  6914 次点击
DefoliationM 小成 2025-10-30 23:27:36
没时间写,写了也没人看,干脆不写了。
xljya 初学 2025-10-30 23:30:11
@cutchop 哈哈 这是真的,代码都没改好,就出来一堆文档
OneLiteCore 初学 2025-10-30 23:36:08
写文档无法当成 KPI 写到工作总结里,和钱无关自然就没人重视了,老板会因为你负责的业务模块赚钱给你发多点年终奖,但不会因为你写的代码可读性良好文档齐全而奖励你。 没有文档无非就是新入职的程序员掉点头发而已,老板不在乎的。 赚钱的是业务而从来都不是代码,想明白了这些就不会有疑惑了。
LeslieLeung 小成 2025-10-30 23:42:08
前面有人说到时间、业绩、维护麻烦、没人看等等理由,我问个扎心的,真要写的时候有没有能力真的写好。 写文档也是需要表达能力的,怎么用简洁通顺完整的话把东西交代清楚,而不是崩一大堆零碎的词就是文档了。
nuonuojump 初学 2025-10-30 23:43:58
得加钱!(开玩笑) 我之前就是负责调研产出文档,经常要的很急,然后周末加班写文档,辛辛苦苦写完了,领导 嗯一下,也没人看。遇见了还是来找你,后来我就开始水文档,反正没人看。有那时间还不如写点技术博客方便装逼。
Ketteiron 初学 2025-10-30 23:51:59
代码即文档没什么毛病 文档这玩意不就是 xxx 模块有什么 xxx 功能,需要实现 xxx 接口等等,让 AI 扫一遍就行了 现在这年头确实没必要写那堆冗余的文档了,有什么注意的请直接写到代码注释里,真有人写也是 AI 生成的大概率没精修过的废话文档
kristofer 小成 2025-10-30 23:59:17
我爱写。我写文档其实也不是为了给别人看的,而是对自己所做的事情的一次梳理吧,不过如果功能迭代,我不会改原始文档,只会追加一份新的。 写文档其实挺难的,先写什么,后写什么,怎么能逻辑通顺,都是学问。写文档其实是一种能力,有的人不写不仅是没时间写,更是没能力写。
woniuppp 小成 2025-10-31 00:24:23
因为没加钱
starlion 小成 2025-10-31 03:42:54
公司项目时间紧,还有公司的工程文化,反正多方面的。 不过现在有 AI ,可以帮你理解,减少一点理解的痛苦
maolon 小成 2025-10-31 05:44:52
现在(或者以后)不搞文档是真的会有问题,都是规范驱动开发( Spec Driven Development )的时代了,文档即代码, 反而你说代码注释必要不,我觉得没那么必要了
返回顶部