PHP is nothing if not amazingly well documented. This is more than I can say for a lot of languages I have worked in cough Ruby cough. I work pretty heavily in Go these days and even it’s docs leave me wanting in comparison sometimes.
>>donatj+(OP)
It is well documented but the comments in the documentation are seriously bad most of the time. I really wish they would at least designate the primary release at the time of the comment, if not purge old ones (the comments from 2005 don't often offer much value nearly 20 years later)
>>donatj+(OP)
If documenting was enough band saws would still just have warnings about fingers in their manuals instead of guard rails. "Weird functions" need to have big yellow warnings at the top of their doc with a link to fixed versions of the func