每一个认认真真写文档的程序猿都会被无良 HR 逼成不写注释的屑码农

[loliordie]

最近离职交接工作, 上一个公司负责的项目有一个我长期维护的文档库, 每一个组件每一个 API 都有对应的文档, 写清楚起什么作用为什么这么设置要如何启动, 还配了一大堆图, 部分比较麻烦的库我还把自己的笔记也粘贴了上去了生怕别人看不懂, 维护的代码也有 GOOGLE 风格的大段注释, 生怕别人看不懂还按照 PEP8 修正了早期不合格的代码, 文档库光我自己的 commit 就有 3000 多个.

结果, 离职了之后 HR 找了个实习生接手项目, 我把文档给他之后, 他又烦了我几天, 天天问文档上都有的问题, 最后终于发现那个文档就是按照教傻子的标准教他们的, 老老实实按照文档来做一个礼拜就上手了.

然后同事跟我说, 那个 HR 现在天天在老板面前吹, 他招了个 4K 的实习生就完美替代掉我这个 2W 的主工程师了, 给自己头上贴小红花...

以后再写文档我就是傻逼, 提交的代码里别想看到一行注释, 总之这个项目离了我就瘫痪, 离职交接后再咨询另算钱.

[ruby0906]

善战者无赫赫之功！

[runningman007]

我从来不写注释,代码我还会加密 ：）

[LeoZhu]

吐槽归吐槽，楼主爽完了以后还是该写注释写注释，该写文档写文档，对自己好

[goodboy95]

偏个题，一看见“教傻子的标准”，我就想起以前那些让人去百度的图：
“这是鼠标，这是键盘，这是电脑屏幕。开机之后，电脑屏幕显示的这个是鼠标指针，这些图标是浏览器图标。移动鼠标到浏览器图标上，快速按两次鼠标左上方的按键。再将指针移到上面输入文字的框，点一下鼠标左键，用键盘输入 www.baidu.com ，最后按一下 Enter 。最后在屏幕中间的框里面输入你要问的问题，按一下 Enter 。”

[matatabi]

哈哈证明楼主写的文档很好，给你一个赞

[ChoateYao]

写的文档自己存档就行了，没必要为他人提供方便，真的以为程序员的世界没有竞争？？见过同事 Copy 了我代码在他的项目用，然后去跟领导邀功，申请成为部门内部标准库的？

[xuhaoyangx]

挺好的。现在公司文档 注释 一坨屎。

[xrr2016]

@shellus 🐂🍺

[leven87]

看公司，看人，看对方的态度。

[liuzhaowei55]

文档是写给自己看的啊

[zzk5173760]

别，写文档是好习惯，坚持，提升和舒适是自己的，总会遇到同类，别为了这个让自己变得跟他们一样

[efcndi]

@zhongjun96 #26 哈哈哈，想起来我之前在某家公司，因为空调太冷，我躲到某个没人用的小房间去办公，不大一会儿被行政和人事赶了出来，说公司领导说现在没有安排小房间住人的计划。

[Torpedo]

所以技术人找工作，一定要有个懂技术的老板

[jessun1990]

不要为这些庸人置气，请坚持自己的好习惯，不要为了庸人降低自己的标准。

[bbqqddwhy]

功德无量，被 LZ 注释照顾的实习生一定也会在以后的生涯里面毕恭毕敬的写注释。

[laminux29]

这个问题的本质是，题主你被别人坑了，所以你要去坑别人。

站在大环境的角度来看，题主这做法不对，会带坏整个环境风气。

站在题主个人的角度来看，这做法并不违背法律法规，而且快意恩仇能让自己开心。

所以，不赞成，也不批评。

但我是题主，我不会选择报仇，也不会选择一个懂技术的领导，而是会选择一个支持我的领导。

[hareandlion]

同意楼上的说法，不要为了庸人降低自己的标准，否则可能始终在泥塘里打滚。
另外最近被工作毒打之余学到了一个词，”知识的傲慢“，但又感觉捏着鼻子了解庸人甚至妄人的想法对自己毫无帮助，同样疑惑中。。。

[drackzy]

不要写博客，不要写面经，不要写注释

[pastgift]

楼主功德无量，请务必坚持贯彻自己的原则，整个软件业的发展靠的就是每个程序员点点滴滴的坚持和积累

[netlichun]

这只能说楼主是未遇明主，真正的伯乐会发现你的价值，楼主可千万不要因为公司操蛋而扔掉了自己的价值！