When I’m hiring, I find most people don’t understand the purpose of commenting.
Brian Lee Yung Rowe
431

Even more annoying is documentation that doesn’t shed any light. For example, you might see a method called setFixedModel and documentation that says “this method sets the behavior to use the fixed model”. Not very helpful. And then you thank google, stackoverflow, and bloggers for bailing out the sorry documentation and actually adding something useful.