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

Code documentation — is there anything more exciting than spending your time writing extensive comments? If I had to guess, your answer is probably somewhere along the lines of “uhm, ye… ...

In a previous column, I discussed why comments in code aren't a good idea.I followed that with another column that looked at some of the objections readers raised (and some things I got wrong). My ...