Jason Baker starts out by saying that writing good comments is under appreciated, and it seems that he is going to show us how to write good comments, but then he goes on to attack comments by listing "misconceptions" that seem to suggest that most comments are worthless.
In the end I'm not quite sure what point he was trying to get across, but I personally like to use comments to keep track of logic flow.
I tend to write my pseudocode as comments by listing the main steps that a function needs to accomplish as comments within the function body. Then I fill in the appropriate code under each comment. This results in typically a comment for every ten to twenty lines of code, with an occasional extra comment if there is something strange that I need to specially document. This is fairly sparse to some new programmers, but verbose enough for me. I personally use this method because not only does it make the code easy to read, but if I stop in the middle of the project to sleep or to eat something I can come back, reread the comments and get that whole mental framework rebuilt.
In case anyone is wondering the parent post is a duplicate post that I made by accident. (Wireless connection dropped me and when I reloaded the page it reposted.) Unfortunately I can not delete it because someone has voted on it, and I can't flag my own post apparently. Anyway, mods please delete the parent post.
In the end I'm not quite sure what point he was trying to get across, but I personally like to use comments to keep track of logic flow.
I tend to write my pseudocode as comments by listing the main steps that a function needs to accomplish as comments within the function body. Then I fill in the appropriate code under each comment. This results in typically a comment for every ten to twenty lines of code, with an occasional extra comment if there is something strange that I need to specially document. This is fairly sparse to some new programmers, but verbose enough for me. I personally use this method because not only does it make the code easy to read, but if I stop in the middle of the project to sleep or to eat something I can come back, reread the comments and get that whole mental framework rebuilt.