Say what you want about the npm ecosystem, but I've found that the most popular libraries to solve a particular problem are almost always the ones with the best documentation. It's natural selection: the ones that are easier to install/use get installed/used more often.
It's to the point where I expect good documentation, and will pretty quickly discard a library if the docs don't look robust on first inspection.
It's sort of bizarre to me that Apple doesn't know this, or at least hasn't acted on it.
I think they know it's bad, they just don't need to make it better because its their OS so they're the only game in town. Developer experience isn't why people write apps for mac/iOS, so there's not much incentive for them to invest in it.
It's to the point where I expect good documentation, and will pretty quickly discard a library if the docs don't look robust on first inspection.
It's sort of bizarre to me that Apple doesn't know this, or at least hasn't acted on it.