Should Apple have provided better docs and interfaces and APIs?
Yes, of course!
We asked for them.
But at the end of they day, they may not. And we need to publish this stuff soon, not in several years when Apple decides it might be a good idea for the next revision