Re: bad documentation
Re: bad documentation
- Subject: Re: bad documentation
- From: Karl <email@hidden>
- Date: Tue, 13 Nov 2001 23:09:24 +1100
When I learned MacApp and Smalltalk I had none of the problems people
are having here (including myself).
Both supplied the source code so when the documentation was
inadequate or I didn't understand something or some behaviour, I
could go look at what was happening. Unfortunately, this is
impossible with Cocoa so you get person after person asking groups
like this simple questions that they should be able to discover the
answers to themselves. Also, what better examples of how code should
be written than the code framework itself?
I understand the position of people who say that you should be able
to use the framework properly if there is adequate documentation.
This works very well in the simple case where your code is a client
of a library like stdio or whatever (who would want to know what goes
on there?), but when you subclass supplied classes (as you almost
always do in Cocoa), your code becomes a part of the framework and I
think the your knowledge of it needs to be a bit more intimate.
Karl
--
----
Klaatu barada nikto (
http://www.wattle.net/klaatu.wav)