Gotta give you some solidarity here even though it's the unpopular opinion. As someone who's been Mac-centric for the past few years I have to say: anyone who claims that Apple supports devs as well as MS is on something.
Apple's documentation cannot begin to hold a candle to MSDN, their direct developer support even worse. Developing on MS platforms is a joy - it's straightforward with copious amounts of documentation provided directly by Microsoft.
Developing on iPhone/OSX is a pain. Much of the "documentation" resembles a Obj-C header file, important details hide in gigantic tomes of text with zero sample code to bring it out. Unexpected/weird behavior is rarely documented... the whole thing is a gigantic labyrinth that breeds tribal knowledge instead of documentation.
My experience with MSDN is one of the biggest reasons why I avoid Microsoft tools. Now you're telling me that Apple's documentation is much worse, and that depresses me.
The problem with straight-up documentation is that much of it is unreadable technobabble that makes no sense until you, say, throw in a diagram or a chunk of sample code. Then you go "oohhhhhh" and are enlightened.
Apple's documentation is "complete" insofar as all the major bits are written down somewhere, but it's very opaque and hard to read. Their ridiculous lack of diagrams, visualizations, and sample code also makes your life much more difficult than it must be.
In fact, I do not think there's ANY sample code anywhere that isn't a "sample project". As in, when Apple does decide to grace your presence with sample code, it's a large, integrated thing that really doesn't help you learn a specific API or component.
Apple's documentation cannot begin to hold a candle to MSDN, their direct developer support even worse. Developing on MS platforms is a joy - it's straightforward with copious amounts of documentation provided directly by Microsoft.
Developing on iPhone/OSX is a pain. Much of the "documentation" resembles a Obj-C header file, important details hide in gigantic tomes of text with zero sample code to bring it out. Unexpected/weird behavior is rarely documented... the whole thing is a gigantic labyrinth that breeds tribal knowledge instead of documentation.
Ugh.