Re: Out-of-date Dev Docs?
Re: Out-of-date Dev Docs?
- Subject: Re: Out-of-date Dev Docs?
- From: Chris Hanson <email@hidden>
- Date: Fri, 26 Oct 2001 18:20:09 -0500
At 5:27 PM -0500 10/25/01, Jonathan Hendry wrote:
It would also be nice if, instead of only releasing developer docs
when the dev tools get updated, they were released as they get filled
in.
Amen to that!
I'd like to be able to subscribe to a docs mailing list, so new docs
would appear in my inbox as they get written, in ones or twos. It
makes little sense for documentation to sit in a hard drive at Apple
waiting for the next release.
Updates could also be pushed out via the Software Update mechanism.
I still miss Toolbox Assistant. I disagree strongly with Windows
developers who laud Microsoft's documentation efforts, but they do
have very quick access to function references. This hodgepodge of
incomplete web pages (some local, some on Apple's web site) and
manual pages and the occasional PDF and a very low-quality help
viewer that you can't even select text in is a serious impediment to
developer productivity.
The apparently near-universal use of HeaderDoc within Apple now could
make it easy to generate something like the Toolbox Assistant
databases. The application itself would be extremely easy to write
thanks to Cocoa; you don't even need to use AIAT (though it would be
a nice 1.1 feature to provide full text indexing).
-- Chris
--
Chris Hanson <email@hidden>
Personal email: <email@hidden>
bDistributed.com, Inc.
Custom software development for the distributed enterprise.
http://bdistributed.com/