我脑子里有个一个问题：世界上最好的源代码是什么呢？于是我用Google搜了一把“What is the best source code”，但是Google并没有了解我的真实意图，回答的是“What is the best source code comment”。

搜索结果第一条来自于我最喜欢的技术讨论网站stackoverflow.com，这个讨论的发起者就是stackoverflow的创始人。从讨论的内容来看，大家说的其实也不是“最佳源代码注释”，而是“最让人抓狂的源代码注释”，我相信每个程序员在生涯中都见过这样的注释。

我也曾见过几个很厉害的注释，不吐不快。

/// <summary>

/// Create a Writer.

/// <summary>

public SomeReader CreateReader() {

    ......

}

到底是创建一个Reader?还是创建一个Writer?

这是一个叫Li Xiang的程序员写的代码和注释，如他所说，因为他实在想不出一个有意义的标识符来命名这个变量，于是就用了自己的名字。

// I don't know how to name this variable.

bool xiang = ...;

相关文章：

1. WordPress 2.9 发布
2. SEO写作
3. Chrome Frame in IE：这是个狠招
4. Chrome Frame性能测试
5. 开源软件不会比“闭源”软件安全？

分享到: 开心网 豆瓣网 人人网 Google书签 Del.icio.us