4 ms·
> Best documentation on the web No, no, no. Poorly or completely undocumented parameters, the "comments" being seen as replacement for coherent examples ... I
by ch0wn 14y ago
> Best documentation on the web
No, no, no. Poorly or completely undocumented parameters, the "comments" being seen as replacement for coherent examples ... I'm not sure if the author is joking or did actually never look at the documentation of other languages like Python's.
- FuzzyDunlop 14y agoMore 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.
- ch0wn 14y agoOr 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.
- Domenic_S 14y ago> Poorly or completely undocumented parameters Example?
- eevee 14y agoI'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.