同事离职，代码交接给我，基本没什么注释，还不愿意写文档。

[jelinet]

如题所述。大体是这样。现在这个同事正在我旁边啪啪啪的敲着键盘表示他的不满。因为他明天就想离职。
可是，可是，代码真的没注释啊。这个东西怎么运行起来我都母鸡啊。就写个大概流程文档，叙述一下主要的方法函数干啥用的，参数返回值啥的，这难道过分吗。。。可能对于他明天想离职，是有点过分。但是没有文档也很难为我啊。
这种问题一般大家都咋对待，是无所谓心态，以后代码自己看吧，随便交接一下；还是必须要交接好。

[anerevol]

对于做iOS开发来说，一般文档就是写给领导看的。
话说最近也在做接盘侠，看到几千行代码几十个成员变量的类，觉得就算有文档写得再好看也没啥用。

[cralison]

我接的也是这样。还不是特别小的产品。
19日入职，20日就开始修Bug做新功能了。这代码已经经过几个人的手，上一任才来2个月，就算让他讲，他也讲不清楚，更别说文档了。
代码就那么回事，只要不是太底层的依靠数理基础的，基本还是可以理清的。当然速度会慢一些。
入职一个月，分析代码的能力暴涨。

编程，无非是数据和针对数据的操作。有一个技巧，拿一排有序数据堆进去，看看输出变化，大概就能猜出是要对数据进行什么样的操作了。

[ybh37]

交接是要有制度来规范的，不是你说啥就是啥！你们平时都不写注释、文档，现在你跟人家说需要补齐，这就是难为人家了。好聚好散~

[xinran505982]

看情况了，我的本来就是有注释的，有时候就是故意，把文档注释用工具全删除，连空行都删除，再提交。而有时候就有很详细的提交。

[xinran505982]

很小人一起做事就一点注释文档都不留，全删除，否则就很详细。

[327beckham]

我怎么觉得，这挺正常的。。。。我都习惯了，还能提高自己阅读代码的能力

[jelinet]

@imcj 我对文档的要求我说过了，就是把业务复杂的地方，方法名字，参数字段，返回值字段代表了什么表示清楚，变量名都瞎起的这样的工作态度我不能理解。我也离过职，我做到了这一点。并且我做的比这个详细。并且我当时也是用了一个星期写完的。
不明你的喷点在哪。

[madmen]

接多了你就习惯了，而且你还会发现乐趣。
哦，原来是这样啊，啊哈哈哈。。。

[jelinet]

@dd99iii
@msg7086

没错，坑的要命，早就想离了。。
这领导也是非常逗逼，每次请假都要问我干吗去。。。。
更逗逼的是前些天入职了一个应届毕业生，待了一星期吧，说代码实在看不懂，要回家。然后前天早上离职了。。。。

[jelinet]

@madmen 以前也不是没接过。。。就是真心没接过代码质量这么差的。。。比如需要操作数据库的，最起码跟数据库字段命名一样吧，复制粘贴的事。。这都瞎起的。。。真是哔了狗了

[jelinet]

@ybh37 我平时写注释，写文档。可能是因为我做的工作是推翻旧产品，重新写。所以自己自觉的写了一些文档。。。也主要想别人接手时能痛快点。。这样也有利于我去做别的工作。不然就永远绑在同一个地方了。。。

[lucky2touch]

能看懂别人的代码也是锻炼之一......不过我说的是结构良好，思路清晰的代码:)

[xujialiang]

说明平时没有code review

[msg7086]

@jelinet 好的代码很少需要注释。
（我说的好的代码，我的意思是带有完整测试并且编写良好的代码）

[madmen]

@jelinet 这个故事告诉我们 如果有机会培养新人 一定要盯住编码规范这一块，一旦坏的习惯养成 对公司，对这个人的将来都是灾难。

[caigaopei]

一点可以说明制度不到位,还有就是要离职的那位同事平时对自己比较松散,代码写注释是最基本的规范,但是遇到这个事情了也只能硬着头皮去梳理了,毕竟也是你的本职工作,换个角度来看,说不定也能吸取到好的东西,毕竟能看懂别人写的东西是一件很伟大的事情... 平常心 平常心!!!

[jelinet]

@caigaopei 谢。说的很中肯。

[eeeeeeve]

同时工作多久了，为何离职？

[maxbon]

公司现在3个项目，源代码全部被前离职员工删掉了，没注释。想当初我从上家公司离职的时候可以花了很长时间把注释和文档全部加上去了的。唉，别人没职业道德没办法，只能靠自己填坑

[jelinet]

@maxbon 删掉这得多大的仇啊。。。