我的一个老老板总是说我们必须在内部使用我们自己的产品。“吃我们自己的狗粮……”

许多年后，我发现嵌入在一个临时同事所做的源代码中，他触及的每个函数都被标记为:

/* NOT FIT FOR HUMAN CONSUMPTION */

'I hate nested regions and will delete them along with any code found in them.

我参与的一个大型项目在自动构建中使用了StyleCop和FXCop，并使用规则来防止人们检入带有未注释字段、方法、属性等的代码。

有些人对必须添加“获取或设置全名”之类的注释到自记录属性(如FullName)感到非常恼火，以至于他们不得不努力编写一个宏来绕过这些规则。

宏为方法、属性等插入了XML摘要标记，其中一个单一的不显示Unicode字符作为标记内容，这将欺骗构建规则，同时对为了注释而盲目坚持的东西进行轻微打击……

.．.至少直到他们引入了另一条规则来检查注释中的Unicode字符。

在为一家芬兰移动网络设备制造商工作期间，我深入研究了硬件抽象层，发现芬兰语单词“puukko”出现了100多次。

“puukko”是一种万能刀，每个芬兰人的工具箱里或家里都有。它被用于从剥土豆到电脑维修(我的观察)的所有事情。我相信在这个语境中，它相当于芬兰语中的“Hack”。

我的芬兰同事否认了这一点，并说这更像是“外科手术/干预”……我差点就相信了，直到我看到下面的评论:

/* Perkele ISO Puukko! */ -> Fucking Big Hack!

const int TEN=10; // As if the value of 10 will fluctuate... 

一个文件中5000多行代码中很少的一些注释 事实上，我和那个为自己的编码风格辩护的程序员有过一次争论…… 无可奉告! 没有评论;-)(或者很少) 遗憾的是，这是产品代码。

offset=1;
for (i=0;i<=len;i++)
    {
    if ((i!=0)&&(i<len)) //-3
        {
        switch(mess[i])
            {
            case ETX:
            case ETB:
            case DLE:
                buf[offset]=DLE;
                offset++;
                break;
            }
        }
    buf[offset]=mess[i];
    offset++;
    }

我喜欢这个开关!

for (n=0;n<offset;n++)
{
    Sleep(TR);  //Modif A
    Sleep(T);//
    FWriteFile(hCom,buf+n,1,&dwMot,NULL);
    if (ECHO)
        FReadFile(hCom,tab,1,&dwMot,NULL);
}

不，没有注释解释什么“修改A”是在标题。

if (GetFileSize(hSlotFile,NULL)==3600)   //5*720

720是多少?