Comment That's why I like(d) PHP docs (Score 5, Interesting) 418
In PHP docs with every item there comes the section for for "user contributed notes" which are sometimes pretty insightful (like there php strings intro or there implode string function ). Long time ago in a galaxy far away when I used to code in PHP those useful comments not only usually saved my day, but somehow compensated for the unorthogonality (well, an understatement) of the PHP standard library and the language itself.
So - yes - I definitely prefer using worse language with better docs than the other way round (think Haskell vs PHP).