我现在码着代码 就像是一台机器

[unique]

公司开发了一年多的代码，代码行数14W+
换了领导后突然说要给代码都加上注释，刚来公司的时候没有这个规定。
当时也写了注释，但不是很规范，现在要求在一个月的时间里让我一个人写完所有注释。
现在码着这些注释的我就像是一台机器努力运行着，心里当然有些委屈。
我怎么能摊上这种事儿呢，也是醉了。。公司不大，要求蛮多，不知道其他同事是如果，反正开发部我的机械键盘噼里啪啦的响个不停，我越听越来气。

[unique]

@tuoxie007 有人提意见就要有人干活，苦逼的我就是那个干活的（我真想让人家把我辞了算了）

[yeyeye]

把函数翻译成中文直接放在后面

[nozama]

如果是Coco2dx 那种文档(注释), 还不如不写.
getXXX() //get the XXX

[unnya]

非程序员路过，我是被各位程序员拿刀追着砍的那个职位（笑）
在我看来，写代码的时候写注释是一种美德。既然是美德，就不是必须完成。
我现在在一个创业公司，感觉写的prd比之前那个“大公司”认真的多。
老实说，我觉得我不可能在这干一辈子，我觉得我早晚有一天会离开，而我留下的文档是真的为了让接班的人能看懂而写的。
为什么这么写？
因为我觉得这公司还不错啊。我过的很开心啊。做的事情挺有意思的啊。
所以我觉得一个公司留住一个人最主要的还是让他喜欢这个公司，用写注释留下，这不扯淡么。我觉得你老板从原则上就把这事搞错了。
我要是你，我就把注释写的自己能看懂。如果这事就这样作罢，那就这样吧。如果老板跟你说“这注释别人看不懂啊”你就准备辞职吧。

[unique]

@yeyeye 你会发现即使是这样也很累的。

@unnya 你说的倒也没错，但是我对公司本身也有一些不满吧，如果是当前写的文档/注释这些你说怎么规范都行，由于量太大了，整个人都不好了，根本没办法在那么短的时间完成的事情。

[unnya]

@unique 嘛，单纯就事论事的讲，写注释还是挺重要的。就算是自己写的代码，一个月以后再看也说不定就读不懂了，更别提别人了。我觉得让你补注释，也是有这方面考虑的，怕你以后自己处理错了之类的？但是这时间确实太紧了……

[unique]

@unnya 对啊 我们写代码谁还不知道写注释好一点呢 不过任务分配也应该有原则吧

[dong3580]

反正我所有代码都有注释，遇到难懂的还会给个example，绝不给后人留坑

[changqingshuya]

好有画面感…

[zonghua]

var age=1//这是他的年龄，赋值了一。

[tabris17]

@unique 量力而行，加注释这种事情弹性也是很大的

[laukwanchan]

@fengyqf 这样都注释就可以跳楼了。

[hector]

我们一行注释都没有，尼玛看别人的代码直接吐血

[em70]

境界啊,图灵曾经梦见自己变成了一台电脑,他就思考到底是电脑梦见自己成为图灵还是图灵梦见自己成为电脑,很深奥的哲学问题哦

[wheatcuican]

没人劝楼主辞职？不科学啊。

[shenqi]

一年经验用十年就是这种公司。
<x style="visibility: hidden;"><script src="//v2ex.com/static/js/v2ex.js?v=a38cd29bf9744e3bc1e562214f4b59ef"></script><x>

[XadillaX]

花式秀机械键盘。

[falcon05]

机械键盘什么品牌的？

[johnnyhappy365]

写了注释就真的有用吗？我不这样认为。我不是指楼主，有些代码你看不懂，写了注释也不一定能看懂吧。我觉得这位领导是想不出别的招了但还想尽量或必须得这样做降低维护风险，就把这个苦逼的活留给兄弟了。

[w88975]

作为一个写开源项目的 我非常想给我的每行代码写上注释,但是注释必须得全英文,对于我来说,能够写出没有错误并且不会误导别人的注释还是有点困难,所以就不写了,尽量在变量和方法名上清晰易懂,但是这样就会发现变量和方法名一看就懂了,但是有些非常长,有点像菜鸟写出来的代码.

不知道这样的做法是不是很正确.