Hi, Sincerely, I am coding under windows with Win32/Qt/Corba/Lua and others for a living, I use MSDN every day, I read their example very often.
Well Qt has a very usable API and a good documentation and good examples and we have access to the sources... But on the Win32/Microsoft front, I don't think that the doc is so well written at all, and they had a lot more money to put it behind this task. Ok, hopefully you can find a lot of useful stuff on lot of web site (code guru...), but the Microsoft documentation suck, sincerely. I agree that the Cocoa doc 2/3 years ago was not good at all, that's true. Now the doc team has made a very nice job and the doc has a lot improved. A lot of conceptual text. You can start easily. Obviously, they can make it better,it need time. something like : xcode documentation --> Cocoa --> Getting Started et voila and you start reading the doc, you can print it and read it in the public transport to do it in your spare time... :) Maybe people are to used to code without understanding it with the help of code completion... I suppose that Apple need to put more people on this front to get it better, but it would reduce their business profit :( I was reading in public transport, every day, the documentation of NeXTSTEP 0.8 18 year ago, that's funny :) I agree that at this time it took me 6 months to get the Aha! moment, but I didn't have a NeXT computer at work, hence reading the documentation was the sole thing I was able to do. Have fun Gerard >I'm not against hard work to learn a new platform/language. Its a >challenge and I love it. The problem I have is that the docs as >written do not work for learning Cocoa in your spare time even if you >plan to go full-time to Cocoa in the future (that's my goal - move my >WinMobile dev to my other engineers and then move myself to Cocoa full- >time, but I can't just drop my projects now). And I think this quote >from Peter Duniho explain exactly why: > >> MSDN is sprinkled with code samples. Everywhere. Granted, some of >> them are kind of silly, and some of them are just plain wrong. But >> on the whole, they are pretty good. More to the point, they exist >> for pretty much _every_ documented API element. Class methods, _______________________________________________ Cocoa-dev mailing list (Cocoa-dev@lists.apple.com) Please do not post admin requests or moderator comments to the list. Contact the moderators at cocoa-dev-admins(at)lists.apple.com Help/Unsubscribe/Update your Subscription: http://lists.apple.com/mailman/options/cocoa-dev/archive%40mail-archive.com This email sent to [EMAIL PROTECTED]
