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