Hacker News Reader

I've heard this same quip a lot, and I don't understand it either. I pored through a lot of PHP documentation to write an angry blog post about it, and it was unbelievably painful; documentation for simple extensions was broken into a dozen tiny useless pages, obvious cross-references were missing, similar items are documented in radically different places, etc. There's a lot of text, sure, but it's poorly organized and not all equally useful.

More often than not, the comments sections are just lists of various reimplimentations of the function for versions of PHP that don't have it, or have a bugged version.

Or they give horrible examples like trusting user input without the necessary disclaimers. It's just a very bad idea for an inexperienced user to rely on those.

> Poorly or completely undocumented parameters

Example?