Re: Frameworks refernce online...
Re: Frameworks refernce online...
- Subject: Re: Frameworks refernce online...
- From: James Duncan Davidson <email@hidden>
- Date: Thu, 22 Aug 2002 11:11:32 -0700
On Tuesday, Aug 20, 2002, at 15:48 US/Pacific, Jonathan Jackel wrote:
Andy Lee's AppKiDo is also a terrific way to use the documentation.
Much
better than Cocoa Browser, in my opinion.
http://homepage.mac.com/aglee/downloads
Before all else, I'm really glad there's multiple people working on
this from different approaches. It's all way more usable than using a
web browser. I hope that this can be considered to be constructive
criticism that will help the developers of both pieces of software.
At first glance, it looks better because there's more UI, but at this
time, I don't like it as much. The reasons why:
1) The top class browser puts everything into a class inheritance
hierarchy. So to use the browser, I have to know where a class is in
the hierarchy. Cocoa Browser displays everything together, so it's easy
to find. Yes, AppKiDo has the drawer which has the alpha lists of
classes--but all that means is that I've not got a browser which I
don't want to use and more screen real estate taken up by all the UI at
the top of the drawer. Bottom line--the non class hierarchy list is
better and only needs to show up once.
2) The Find button on the drawer looks inviting, but only works with a
complete class name. If I want to see all classes with "Control" in it
because I'm not sure which control to use, it doesn't work.
3) No Function or Types reference. They've said it's coming, but.
Until it's there, I can't use it much at all as that's where I spent a
lot of time looking for documentation.
4) No Java reference. Objective-C only.
5) Ugly Icon. Cocoa Browser has a much nicer icon that uses
transparency.
6) No way reference on Protocols, Classes only right now. Lots of
functionality is buried in those Protocols. (By the way, while making
sure that there wasn't protocol docs, I clicked on NSString in the
AppKit list and got the Foundation NSString docs...)
To be sure, there's a few things I wish were different in Cocoa Browser:
1) The Function and Type items should be in the first column of the
browser, not the second. As it is they are buried unnaturally and I
always have to remember to click on "Foundation" or "App Kit" first.
2) I'd really like to be able to search some how. A search box in the
toolbar ala the new finder model would be really cool.
3) Having four parts to the browser is a little crowded. AppKiDo might
have discovered something by using the list of classes down the side
and having a two part browser right above the documentation HTML
display area. Don't know... A little more work on this is needed.
And for either, there's more functionality that I want..
1) CoreFoundation reference
2) Carbon reference
3) BSD
4) Core Graphics
...
Anyways, just my thoughts... :)
_______________________________________________
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.