Path: utzoo!attcan!utgpu!jarvis.csri.toronto.edu!mailrus!husc6!cs.utexas.edu!milano!molokai!werner From: werner@molokai.sw.mcc.com (Werner Uhrig) Newsgroups: comp.sys.mac.programmer Subject: Re: A plea for revised mac programming documentation Summary: more dry humour ... Message-ID: <2361@molokai.sw.mcc.com> Date: 17 May 89 11:39:36 GMT References: <496@grand.UUCP> Organization: MCC, Austin, TX Lines: 54 In article <496@grand.UUCP>, day@grand.UUCP (Dave Yost) writes: > Imagine... > > It's 1990. A programmer, perhaps already expert in > another type of system, finally gets the message that > the Mac is great, and wants to learn how to program it. > > Scenario 1: ....I couldn't think of a humourous remark to this sad description of the state of affairs ... > Scenario 2: > > He goes out and buys The Macintosh Technical > Documentation, Version 7.0 (10 volumes). These > books have revision bars in the margin for the > benefit of old-timers, but he ignores them. He > reads the tutorial in the first few volumes, feels > like he has a clear and consistent view of mac > software, then he proceeds to produce good code, > occasionally referring to the reference material in > the remaining volumes, and to the 200-page, totally > complete two-level Index. hehe, I've said since 1984 that Apple missed out on learning one thing from Big Blue: how to write documentation that can be supported over the years; I still say the same thing. I only had to grin when I thought of the commercial Big Blue could launch, IFF they'd ever get down to mentioning the competition: Remember the 1984ish Apple TV-ad with showing the itty-bitty Macintosh-documentation "butterflying" down on the table ? "that's all you need on the Macintosh" ... ...followed by the 1990-reality *CLUNK* of the 10 volumes; welcome to the "real world", kid. wait until you get promoted to the second grade where we'll talk of "virtual memory", "version-control", "automatic job-scheduling", "macro-languages", "generation-file-names", "source-code control", ... well, at least marketing behaves like IBM-clones already ... -- --------------------------> please send REPLIES to <------------------------ INTERNET: uhrig@mcc.com (if unavailable: werner@rascal.ics.utexas.edu) UUCP: ...!milano!werner ALTERNATIVE: werner@astro.as.utexas.edu OR werner@utastro.UUCP