你遇到过的源代码中最好的注释是什么?


当前回答

// BEGIN HACK
...
// END HACK: I feel dirty.

其他回答

try {
   doSomething();
} catch(err) {
   // Die quietly
   alert(err);
}

这是我们团队微观管理效果的一个活生生的例子:

// I am not responsible of this code.
// They made me write it, against my will.

... 我们敬爱的技术总监很喜欢把代码和编码指南都硬塞到开发人员的喉咙里(*)。

当然,当项目负责人寻找bug的原因时,发现它在“非最佳代码”中,他就不那么高兴了……

(*)当然,我指的是强大的VB国王……如果你想评估强大的VB国王的全部力量,你可以阅读下面的SO帖子:你被迫遵循的最奇怪的编码标准规则是什么?...

生产源代码:

// Remove this if you wanna be fired
/* Please work */

下面是一个必须声明的局部变量,只是为了将一个常量传递给库函数:

// This only exists because Scott doesn't know how to use const correctly