Comments can easily get out of sync with reality This may be true, but I find that every other form of documentation becomes out of sync with reality even more

Comments can easily get out of sync with reality This may be true, but I find that every other form of documentation becomes out of sync with reality even more easily, and/or is not in the right place to be noticed when some code is being edited.