'NO COMMENT

// error codes
#define ERROR_SUCESS 0
#define ERROR_SUCCESS_IS_MISSPELLED 1

没有定义其他错误代码。

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

A:很简单——就是那个帮我解决了我当时遇到的任何问题的人，而且有很多这样的人!

其次是那些帮助指导新开发避免已知陷阱的方法。

这不是严格意义上的评论，但是…

那是20世纪90年代中期，我正在进行一次大的迁移:小软件供应商，大客户，压力很大。我们有很多转移门柱的东西;这个项目很难控制。我是关键的开发人员，但对系统还不熟悉，而另一个开发人员是供应商的所有者/创始人。

在几个月没有按时完成任务，也没有让客户满意之后，公司的所有者/创始人找来了另一名远程工作的开发人员。(我可以大胆地说，新开发人员的技能和经验都不如我。)

好吧，这个新人对我已经做过的代码做了一些更改，然后一两个月后我又回到了代码的同一区域，其中有一些我以前没有见过的变量。他的名字叫StupidMark。

伙计，这是不对的。我的意思是，有团队合作方面的考虑，但是:在这个环境中，变量名可能会出现在运行时错误消息中。我只是说说而已。

在我看来，那个新人的代码并没有让我们更接近可交付的产品，这让侮辱变得更伤人了。

javascript函数的第一行:

// this part is more difficult

WTF?

// Caveat implementor