I almost always end up scrolling straight to that section in the PHP docs when looking for help. Such is PHP.

Ditto, and I don't even mean it in a bad sense. After you get used to it, this really isn't that bad, this format seems to work for PHP. I'd even say, that because of that PHP docs turn out to be quite better than "clean and nicely written" ones for other platforms.

Worst is that some information is only provided in the comments and not in the documentation itself.