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

[loliordie]

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

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

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

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

[leimao]

HR 不得干政

[green15]

当做写注释文档帮自己梳理思路

[levelworm]

写注释主要是给自己的。。。其他无所谓了

[levelworm]

另外这事情楼主领导没有和老板解释么？那也不值得留恋了。

[neighbads]

早该有这觉悟的

之前有个老哥发帖说职场上应该有点私心，被喷成 go 。。。

[daozhihun]

不用在意啦，路遥知马力，新人水平怎样，以后总会体现的

[laike9m]

写文档是好习惯，被坑不是你的问题，而是公司管理的问题。你应该去一家注重代码质量和可维护性的公司。正所谓物以类聚，人也只有在合适的地方才能发挥价值。

[djs]

很多公司都这样，我们公司，你解决了什么疑难杂症也没见的领导觉得你咋样，写文档也不会对你有加分

[lights]

文档是写给 leader 看的

[jorneyr]

但行好事，莫问前程

[HENQIGUAI]

勿偏激

[opengps]

工作终究只是工作，很多时候不适合掺杂情怀，所以我把自己想写的东西放在业余

[Foxkeh]

上家公司 HR 得瑟, 然后你要去祸害下家吗? 这样不好吧哈哈哈哈.

[dustinth]

LZ 心态不行, 零和思维.

[matrix67]

文档写的好，总会占到便宜的。不用急。

[SJ2050cn]

你这让我想起了一个笑话。代码写的完美的人，每个人都看得懂，看起来谁都可以替代的，而那些代码写的一团糟的，每天风风火火改 bug，关键谁都看不懂他写的，反而成为无可替代的人。

[murmur]

我把文档给他之后, 他又烦了我几天, 天天问文档上都有的问题,

这就是你的不对了，离职之后就得付费咨询，哪里有离职了还帮着擦屁股的

[gimp]

交接文档我会整理的很仔细，要走的时候，就算是 shi 山，也要给后人留条路。

[gimp]

特别是现场的问题，一些解决问题的黑科技思路，不注明两个月后自己都会忘，做好记录总归是利人利己。

[wctml]

写自己需要的文档就行，不要为了照顾别人而写。写了接手的人也会来问你。