Re: Documentation frustrations
Re: Documentation frustrations
- Subject: Re: Documentation frustrations
- From: Raffael Cavallaro <email@hidden>
- Date: Sat, 9 Jul 2005 01:14:29 -0400
On Jul 9, 2005, at Sat, Jul 9, 12:34 29 AM, mmalcolm crawford wrote:
No, it's the API reference for Application Kit.
The authoritative reference for Cocoa is ADC Home > Reference
Library > Documentation > Cocoa.
But that's precisely the point!
ADC Home > Reference Library > Documentation > Cocoa is *not* a
single, authoritative set of documentation. It is dozens of different
documents, of a number of different types -API Reference, Conceptual
Documentation, Sample Code, Q&As - none of which take responsibility
for being complete or up to date.
I single out the API reference since it should - at least in theory -
provide a *complete, authoritative, and up to date reference* for
everything a developer can do using Cocoa something which is not true
of the other doc types. If the API Reference became the core, then it
would be scrupulously kept up to date, not have Q&As added to it
without even having pointers to them. It would also have sample code
embedded in it.
As it is, one has to consult far too many different documents to get
complete, authoritative and up to date documentation for simple things.
regards,
Ralph
Raffael Cavallaro, Ph.D.
email@hidden
_______________________________________________
Do not post admin requests to the list. They will be ignored.
Cocoa-dev mailing list (email@hidden)
Help/Unsubscribe/Update your Subscription:
This email sent to email@hidden