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.

No programmer wants to turn simple code into a Dickens novel of comments, but all to often we end up producing code which, years later, reads like the Voynich Manuscript. The best commented code ...

More on code commenting: Why You Shouldn't Comment (or Document) Code To Comment or Not to Comment A few weeks back, my column on the value of comments in code caught a lot of comments itself. To a ...

Are you writing your code for humans or computers? I wasn’t there, but my guess is that at the dawn of computing, people thought that they were writing for the machines. After all, they were … ...

Mahbubur R Aaman Asks: One of my team members consistently avoids making comments in his code. His code is not self-documenting and other programmers have a difficult time understanding his code.

Comments should focus on the codes objective, not the method by method details. I suspect part of the problem is a poor naming convention, as "tempNetTotal" says a lot more than just "temp." ...

Linux developers clean up code comments to align with the new contributor code of conduct.

It may not be a multi-million dollar venture-backed startup, but Lev Walkin has an elegant solution to a common feature of the social web, commenting.