评论的好用例子

11

我一直很讨厌那些用星号填满半个屏幕只为告诉你这个函数返回一个字符串的注释,我从来不看那些注释。

然而,我会阅读描述为什么要这样做以及如何实现的注释(通常是代码中的单行注释);这些对于理解别人的代码非常方便。

但是当写注释时,我不会写那种注释,相反,我只在编程竞赛中编写算法时使用注释,我会考虑算法将如何执行它的操作,然后在注释中写下每个步骤,然后编写与该注释相应的代码。

例如:

//loop though all the names from n to j - 1

除此之外,我无法想象为什么有人会浪费宝贵的时间写评论,而不是编写代码。

我是对还是错?我有什么遗漏的吗?我不知道其他好的评论用途吗?


7
重复几次,用不同的方式重新表述:http://stackoverflow.com/questions/tagged?tagnames=comments&sort=votes - Roger Pate
11个回答

0

网页内容由stack overflow 提供, 点击上面的
可以查看英文原文,
原文链接