Path: utzoo!attcan!uunet!samsung!gem.mps.ohio-state.edu!tut.cis.ohio-state.edu!ucbvax!agate!brahms.berkeley.edu!silverio
From: silverio@brahms.berkeley.edu (C J Silverio)
Newsgroups: comp.sys.mac.programmer
Subject: Re: Better Documentation, a modest proposal
Message-ID: <1989Nov5.061417.3868@agate.berkeley.edu>
Date: 5 Nov 89 06:14:17 GMT
References: <1989Nov1.232424.8861@agate.berkeley.edu> <1405@adobe.UUCP>
Sender: usenet@agate.berkeley.edu (USENET Administrator;;;;ZU44)
Reply-To: silverio@brahms.berkeley.edu.UUCP (C J Silverio)
Organization: Bath Department, UC Merkeley
Lines: 20

Brian Bezanson wants me to know that:
   Inside Mac is available from APDA in a 3-ring binder format (at least the
   catalog lists it). It still wasn't available last summer due to printing
   problems. Combine the 3-ring format with the technotes and you'd be able
   to keep yourself up to date.

Well, that's a great thing, but I really want the chapters on Inside
Mac themselves re-written to incorporate all the supplemental and
"clarifying" information into the original texts.

Think of how much easier this would make the Menu Manager, for
example. Instead of the three IM chapters and numerous Tech Notes that
chronicled its evolution and helped explain its gestalt, there could
be one clear, concise chapter that had been re-written a few times.
After all, the Menu Manager is really quite simple to use, once you
clear the hurdle of collating all that information about it.

Incidentally, it's also been pointed out to me that APDA has a library
of sample code that covers many common Mac programming situations. I
can't hardly wait to get it all.