I am sometimes asked about my position on code comments, and, like most things, I have strong opinions about it. Two kinds of comments exist:JavaDoc-style comments (which encompasses JavaDoc, XMLDoc, RDoc, etc), which are designed to produce developer documentation at a high level (class and method names and what they do)In-line comments, generally scattered around the code to indicate a note from developer to developerBoth kinds of comments represent different smells, each with different...
more »