On May 20, 2008, at 10:50 PM, Steve Weller wrote:
However you slice it and whatever your personal experience, I
believe that what we are experiencing with the docs are the early
symptoms of massive scaling of the problem vs. insufficient scaling
of the resources to tackle it. If anyone can fix this, it is Apple.
and writing a blog post most likely won't change that situation.
You've got to contact Apple directly (i.e. bugreporter)
If you care to invest the time, I have 3400 words on the subject here:
http://www.bagelturf.com/files/8f2cab87e2f633752047fcac70643352-1179.php
A few (hopefully helpful) pointers.
Conceptual doc books are
* Getting Started
* Fundamentals
* Programming Guide
Looking in the reference library, there is a pop up that allows you to
select the type of doc you see. Guides are conceptual.
I'm not sure where the commenter Justin was looking for Cocoa sample
code, but there certainly is a section for it. It is on both
developer.apple.com, and visible in the same popup.
Yes, some things are out of date. And if you find them before we do,
file bugs. or feedback. (bugs are typically better, since we can then
communicate with you if necessary).
If there are specific areas where sample code is needed, file
enhancement requests. Both Tech Pubs and DTS try to be responsive to
these issues when we get specific requests to show how to do "foo".
Ultimately, learning is a very personal experience and we all do it
differently. I'm not surprised that there are issues for some
developers with the docs. We do our best to get you what you need.
_______________________________________________
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]
