RE: Docs
RE: Docs
- Subject: RE: Docs
- From: Angela Brett <email@hidden>
- Date: Thu, 23 Aug 2001 13:22:01 +1200
At 4:19 PM -0700 22/8/01, Stuppel, Searle @ San Diego Central wrote:
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.
I completely agree that the docs could do with improvement - the
summaries as you suggested, examples of how to use each thing, and of
course, the arrival of all these 'Forthcoming' parts. I was just
pointing out that although we don't have those things, there still is
a decent way of searching the docs (although of course the search
doesn't intelligently turn searches like 'parse' into 'interpret'.)
I'm sure the docs will improve with time though, and in the mean
time, at least we can ask each other about things if we can't figure
out how to do something. We know from all the 'Forthcoming's that the
documentation isn't yet a finished product (and Mac OS X itself
doesn't seem 'finished' in some ways either, but I'm still glad to
have it now), so there's a good chance that when it is finished it'll
be absolutely wonderful. Yeah, I guess the documentation should have
been finished already, but I was just so chuffed to find a Developer
Tools CD in that Mac OS X box that it doesn't bother me too much. :^)
As a Cocoa newbie, I have found that sometimes it takes a while to
figure things out, but once I've learnt how to the Cocoa objects etc
have been easy to use.
As for NSScanner, I think it's perfectly normal, when learning a new
development environment, to discover something halfway through which
would have been a great help in the beginning. It's happened to me
long before Cocoa. No matter how good the documentation is, you can't
know everything straight away unless you read all the documentation
before writing a line of code (which would be dead boring!) Some
things you won't even be searching for because you never even
considered that those capabilities might exist. It's just a part of
the learning process/adventure.