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.