Documentation Newbie Blah, blah, blah
Documentation Newbie Blah, blah, blah
- Subject: Documentation Newbie Blah, blah, blah
- From: Craig Bakalian <email@hidden>
- Date: Fri, 09 Nov 2001 18:23:46 -0500
on 11/9/01 4:08 PM, email@hidden at
email@hidden wrote:
>
I see several solutions:
>
For 1), Apple could include every method from every superclass in the
>
documentation for every class. That would only expand the size of the
>
documentation by a factor of 5 or so, but then people would not have to look
>
in more than one place as often.
>
>
For 2), Apple could/should just scrap the shitty Sherlock and revive Digital
>
Librarian or something better. People could also start using google.
>
Google is very handy for searching Apple's on-line documentation.
>
>
For 3), more is better, but most of the newbies posting have never bothered
>
to read Object Oriented Programming and Objective-C. I don't know how we
>
can expect these people to read any kind of overview if they are not willing
>
to even learn the language of the frameworks.
>
>
For 4) If people will not change and/or can not see the advantages of a
>
different way of doing things then I don't think Cocoa will ever appeal to
>
them. I suggest that we forward all such people to the Carbon lists.
Why don't you just say, "Apple needs to improve the documentation." And, I
am so, so, sorry that I am not as smart as you. For you, you are the one
who understands everything, and I, I am a newbie proud and true.
Craig Bakalian
http://home.earthlink.net/~testconstructor/