> The parent said that Apple "could improve" their documentation, not that it was worse than Google/Microsoft/IBM/whomever.
Do you have any examples of big libraries where "they could improve the documentation" is untrue? I can't think of any offhand.
(This is not snark. I'm honestly interested if you do.)
APIs are perpetually under-documented, in my experience, so the parent comment's observation is essentially an empty statement.