Comments Rarely Improve Your Code

The debate over comments in code is ongoing over the past 30 years. Most comments are unnecessary and are not intended to improve the code itself. Frustration and jollification are low utility for the reader, but they do nothing to improve code. Comments Rarely improve your code, but often do not improve it, says John Defterios. Comments are often unnecessary and, interestingly enough, give us a clue as to how the code might be more clearly written. Comments should be used to generate a reference manual, he says.