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

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