Re: List of delegates
Re: List of delegates
- Subject: Re: List of delegates
- From: "Michael P. Rogers" <email@hidden>
- Date: Tue, 7 May 2002 19:48:13 -0500
At 0:35 +0200 8/5/02, Ondra Cada wrote:
(c) find "delegate" gives a link to "Notifications and the
NSWindow's Delegate" at the 3rd hit. First of the delegate-specific
methods there is "windowShouldClose:", and searching it goes
directly to the target at the 6th hit.
Yes, well, this makes the original poster's point, exactly. This
isn't reading the manual, it's using it as the basis of a treasure
hunt; and good documentation should not force the user to do that, it
should spell it out. Treasure hunting may be a valuable developer's
skill, but I can't believe that any serious developers prefer it over
having the information jump off the screen at them and wrestle them
to the ground.
Look at the Java APIs @ java.sun.com -- links to all the implemented
interfaces, fields, constructors, and methods, subclasses and
superclasses, *all* visible at the top of the page, no paging
required. Packages are at top left, classes within a highlighted
package at bottom left, and the class details taking up most of the
page at right -- a massive amount of information but very easily
navigable.
The Cocoa docs will get better, with constructive criticism from
people on this list (*especially* the people who don't already know
the material).
[Previous poster's gratuitous insult, and this author's gratuitous
query as to his relation to John Wozney, deleted]
We should probably continue this conversation, if you feel so
inclined, offline: since I believe one of your implicit concerns was
waste of bandwidth that results when users fail to RTFM, and lord
knows I've wasted enough bandwidth already (except of course that I'm
putting this in my tenure file...).
MPR
--
---------------------------------
Dr. Michael Rogers
e-mail: email@hidden
Phone: 217-424-6327
For information about Computer Science at Millikin University, visit
http://math.millikin.edu
For information about astronomy, check out
http://twincityamateurastronomers.org
_______________________________________________
cocoa-dev mailing list | email@hidden
Help/Unsubscribe/Archives:
http://www.lists.apple.com/mailman/listinfo/cocoa-dev
Do not post admin requests to the list. They will be ignored.