[alttag]

I agree.

In addition, I hope the next "fix" will be to cull the comments. While there are occasionally some worthwhile edge cases documented in the comments, there is also a great deal of spectacularly bad design advice, which doesn't help PHP's reputation among language elitists as being for script kiddies and beginners.

[ericras]

The main reason I like the comments on php docs is it's helpful for me to see a basic usage example. A lot of docs (your typical 'man' page for instance) just have a dictionary-like wall of text without a usage sample.

[vital101]

That would be nice. If they won't cull the comments, I'd like to see them make the lower rated comments harder to see, or have some kind of warning near them that says "If you use this, you're going to have a bad time."