We've written before about the value of writing your README before your code, but what about when it comes to the actual code? Terse one-liners? Paragraph-long descriptions? How much is enough and ...

Peter looks at how rewriting some complex code -- purely to make it easier to read -- eliminates the need for writing comments. He even adds a comment to some code. In a previous column, I discussed ...

Recently I was intrigued by Joe Kunk's On VB column about commenting code. I especially liked Kunk's comment that: "It's important to communicate what the code should be doing." I thought that was the ...

Inline comments, also known as single-line Java comments, begin with two slashes, and only impact the code on the line in which they appear. The following is an example of a single-line comment in ...