Re: Documentation frustrations
Re: Documentation frustrations
- Subject: Re: Documentation frustrations
- From: Raffael Cavallaro <email@hidden>
- Date: Sun, 10 Jul 2005 00:29:36 -0400
On Jul 9, 2005, at Sat, Jul 9, 3:19 18 PM, m wrote:
If you want to learn, don't be a cheapskate:
Cost is most certainly not the issue here. I already own every book
you list in your post, as well as a number of others. The principal
problem with these books is that they are often obsolete as soon as
they are published. The existing Apple documentation is far more up
to date than any printed book on Cocoa I've ever seen.
As for a concrete, positive suggestion, the easiest way to increase
the usefulness of the existing documentation assets would be to add
to the hypertext linkage among them. All of this could be
accomplished in an automated fashion. It would require writing no new
documentation, just a few scripts to parse existing documentation and
automatically add new links to automatically generated pages that are
just a list of links to other locations in the docs - such as
existing example code - where the same class method, instance method,
protocol, constant, etc. is used or mentioned. I believe that this
would represent the work of a couple of person days at most and would
increase the usefulness of the already existing documentation quite
significantly.
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