注释作为代码的补充，它来说明代码未说到的东西，有自己独立的价值。注释相比于其他文档，离代码最近，也就最容易被看代码的人关注，最容易被写代码的人去更新，自然的有更大的价值。我们知道衡量一个文档的价值，一个重要因素就是被人参阅的频率。要提高这个频率，就要它很方便的被人拿到，打开和阅读。注释在这方面无疑是最有优势的。 我们要避免那些“假注释”。没有附加值的注释都是... [阅读全文]