Comment by zarzavat

That's just a normal part of Mac development. Apple sees documentation as a net negative for them, something that can constrain them in the future. So they only document the major highways and leave everything else as an exercise to the reader.

If you're using an unstable API they expect you to figure everything out yourself. It doesn't mean that they don't want you to use it though.