I used to read the comments on PHP.net to learn more about certain features or to find example usages. This made the PHP community seem very approachable and helpful.
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.
Of course all of that should have been in the docs to start with, but the comments really saved that site.