[camtarn]

Similarly! You always wanted to read the comments, because the docs would not necessarily tell you that such-and-such a function had tricky edge cases, or had been replaced by a better version, or was a massive security risk.

Of course all of that should have been in the docs to start with, but the comments really saved that site.