最近离职交接工作, 上一个公司负责的项目有一个我长期维护的文档库, 每一个组件每一个 API 都有对应的文档, 写清楚起什么作用为什么这么设置要如何启动, 还配了一大堆图, 部分比较麻烦的库我还把自己的笔记也粘贴了上去了生怕别人看不懂, 维护的代码也有 GOOGLE 风格的大段注释, 生怕别人看不懂还按照 PEP8 修正了早期不合格的代码, 文档库光我自己的 commit 就有 3000 多个.
结果, 离职了之后 HR 找了个实习生接手项目, 我把文档给他之后, 他又烦了我几天, 天天问文档上都有的问题, 最后终于发现那个文档就是按照教傻子的标准教他们的, 老老实实按照文档来做一个礼拜就上手了.
然后同事跟我说, 那个 HR 现在天天在老板面前吹, 他招了个 4K 的实习生就完美替代掉我这个 2W 的主工程师了, 给自己头上贴小红花...
以后再写文档我就是傻逼, 提交的代码里别想看到一行注释, 总之这个项目离了我就瘫痪, 离职交接后再咨询另算钱.