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

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

A few weeks back, my column on the value of comments in code caught a lot of comments itself. To a certain extent, I feel like Dirty Harry in Magnum Force: "I'm afraid you've misjudged me"…but not ...