4 ms·
I prefer explanatory variable and method names to comments. Comments lie: they cannot be specced or debugged, and few if any developers take responsibility to e
by davnola 16y ago
I prefer explanatory variable and method names to comments. Comments lie: they cannot be specced or debugged, and few if any developers take responsibility to edit and maintain comments made by others.
As a rule of thumb, I comment only when there is a surprising externality relevant to the code e.g. performance, obscure workaround.
- gruseom 16y agoIn my observation, many programmers who advocate liberal commenting have no discipline whatever when it comes to maintaining all those comments. That ought to disqualify them from any debate on the subject. Unfortunately, except for the few one has personally worked with, it's impossible to tell who they are. :)