RE: Docs
RE: Docs
- Subject: RE: Docs
- From: "Stuppel, Searle @ San Diego Central" <email@hidden>
- Date: Wed, 22 Aug 2001 16:19:13 -0700
as i was saying in some other email to Ondra, "interpret" and "scan" would
be the last words i would think of searching for when i am looking for a
function to remove URL's out of a NSString.
Besides, if cocoa is supposed to come with documentation, shouldnt that
documentation be accurate and informative? instead of sketchy and vague? Not
to be sarcastic, but is that really too much to ask? or expect?
<well deserved rant>
Apple is well known for the amazing user experience it creates. Well the
documentation for developers is the total opposite of that. Just becuase we
develop FOR the mac, does that mean we should have inferior documentation to
the regular apps that are standard on OSX? Developers are the primary cause
of a operating system working over time. Without developers you have noe
apps that people want to use. You create crappy docs, it leads to crappy
workarounds like the one i came up with earlier to do with NSMenu, which
leads to borked programs and a bad end-user experience for people using the
software that i develop. Spending the extra salary or two compared to the
endless problems that bad documentation can cause, surely is in the end far
better for Apple.
We just wish apple gave a damn about its documentation. To say it's attitude
towards it is poor is an understatement. OSX has been out long enough for it
to have been done RIGHT.
</well deserved rant>
Admittedly I am a novice programmer, but I feel so alienated by the poor
docuemntation of osX, that I struggle to see why I would continue attempting
to develop for it. I am not stupid. I can read and learn and figure things
out. But somehow osX mytifies me like nothing else.
searle
email@hidden
www.sketchwork.com
Searle Stuppel
CB Richard Ellis, Inc.
Direct: 858-546-4600
Fax: 858-546-4616
Toll Free: 800-334-9347
email@hidden
-----Original Message-----