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 ...

Source code that is well documented can decrease design cost and time to market by providing the insights into the software that would otherwise require time and experimentation to jog the developers’ ...

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 ...