PHP's comments are moderated, and I don't believe that a comment is even allowed on the page until it's passed at least some moderator's standards.
That said, I think the comments absolutely belong there, as it's typically where I find the gotchas that don't make it into the language docs. Comments like "you can use this function most of the time, but if you're foo, functionB() is faster for those cases" are invaluable in optimization, and are seldom well-published in official language docs.
What that means is that I can be a slow expert in the PHP language versus the years of experience it would take me to divine those truths working in another language.
That said, I think the comments absolutely belong there, as it's typically where I find the gotchas that don't make it into the language docs. Comments like "you can use this function most of the time, but if you're foo, functionB() is faster for those cases" are invaluable in optimization, and are seldom well-published in official language docs.
What that means is that I can be a slow expert in the PHP language versus the years of experience it would take me to divine those truths working in another language.