Re: Documentation frustrations
Re: Documentation frustrations
- Subject: Re: Documentation frustrations
- From: mmalcolm crawford <email@hidden>
- Date: Sat, 9 Jul 2005 21:57:03 -0700
On Jul 9, 2005, at 9:29 PM, Raffael Cavallaro wrote:
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.
No, it could and would not (as my earlier illustration showed).
It's not helpful to make assertions like this without knowing
anything about the production process.
Suggestions as to how the documentation might be improved to better
present the information, what information is required, and so on, are
welcome, but please don't make misleading claims like this.
mmalc
_______________________________________________
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