Agree with you completely. It's pretty frustrating how it works, and I really wish Apple would release some documentation on this.

I'm sure there is more to be found reverse engineering but once I had enough figured out for our uses I stopped.