The only thing worse than programmers who won't comment their code, is programmers who fail to update the comments when the code changes.
I've recently had some serious hair-pulling moments with a (python) library because all the docstrings talk about the API a year ago, while the code has been under active and non-backwards-compatible development for 12 months.