I agree 100% with your observation about most teams, and how hard it is to get people to write comments that aren't on the level of `# increment i`. I also lik

I agree 100% with your observation about most teams, and how hard it is to get people to write comments that aren't on the level of `# increment i`. I also like your tip about not putting specific variable names in comments. I'll have to think about that. It's hard to describe trick pieces of algorithms without naming names, though. Maybe the article should be read as hints to folks who are trying hard to write understandable comments. As an example, I try to write comments without the "to be" verb, because I find using "to be" forms decreases the reader's chances of distinguishing variable type from its contents, and action from actor. Would I impose this on my team? Never.