// now swap like a <explicative removed>

我刚刚完成了一个日志框架(使用Trace，为什么没有这样的存在我不知道)。我做了一个继承自TraceListener的方便基类。它覆盖了所有的TraceListener方法，并将它们路由到一个方法中——因此有很多文档注释:

// TODO: Need some codemonkey to doc comment this class.

Repeat
    ...
Until (JesusChristsReturn) ' Not sure

long long ago; /* in a galaxy far far away */ 

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

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

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

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

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

从Joomla !来源:

// fudge the group stuff