I loathe PHP's documentation. I've written elsewhere why, but it comes down to two factors:

  - The site's colour of orange on gray is impossible for a 
    colour-blind person to read.

  - The comments are not authoritative, so you get well-meaning
    but ignorant comments that are incorrect.