The tech community does not have a culture where you can be openly critical about other people's social skills. If you go like "You shouldn't do that", its seen as an attack against their greatness instead of an invitation for self-reflection.

> stuff that Apple could have just documented

I am not sure if this is valid point. Why would they document publicly something, what is supposed to use just by them?

Their business model goes directly against that. But it is not just Apple but any closed source project. No point on wasting resources to document publicly something which would weaken their own business model. Not saying that it is good for general good, but makes no sense from business point of view.

Anyway, if you document something too well, just same to make it open-source instead.