This is mindboggling to me. One of the richest companies in thew world just leaves this janky partially documented mess for developers to wade through like mud.

This is mindboggling to me. One of the richest companies in thew world just leaves this janky partially documented mess for developers to wade through like mud. How can MS claim to hire 'the best of the best' when such a commonly interfaced piece of their product is garbabe? Why isn't it refactored to be clear, concise, with simple documentation and tutorials? If we were to be cynical we could say 'they don't want you to because competitive this-or-that' - ok, money would be a reason. But it's not that. It's just a turd. Mac is a bit similar, in that it's hard to find what goes where and why, with all of the examples. The entire development world before mobile I think had this anti-product attitude: they don't give a s**. You're 'stupid' for not having it figured out. The 'documentation is there!' (but really only in some obscure way). People move on, nobody cares. Who in MS has the job to 'care' about such a thing anyhow? These kinds of things drive me bananas. These are the biggest and richest corporations to ever exist. It should be clear, documented, with tutorials, examples and searchable.