• Just weighing in...  good points in the article...  I think some comments have their place, for example when you do something strange in the code for a good reason.  An example I used recently is I had to create an in-line query that was nested twice.  It was very unpleasant but it did the job.  I commented it carefully so that developers who had to maintain the code could understand the thought process and why it was done like that. 

    My only pet-peeve regarding comments is when developers comment out reams of code and LEAVE IT IN THE PROGRAM.  Trying to read and decipher that is a difficult task.  It is even more pointless if you are using a version maintenance tool, such as SourceSafe.  Just remove it, add a comment if you must indicating that code was removed and refer to SourceSafe.  When I have to maintain a new program, I do 2 things, one is add whitespace, as article author indicated, and two is delete commented out code. 

    MikeZane