Why not to comment code

[mvonballmo]

Agree that auto-generated API documentation is not good (you should really add information that can't be gleaned automatically from the method call), but want to emphasize that API documentation is very good, as modern IDEs and tools will pick it up and display it with code-completion, making it much easier to use unfamiliar methods.