Re: A documetation suggestion (was Re: Cocoa et al as HCI usability problem)

2012-01-30 Thread Andy Lee
A friend pointed me to a *really* interesting documentation browser with features along these lines. ("Classes and methods have their own wiki pages" is what reminded me of this old thread on cocoa-dev, but there's lots more.) I've only played with it a bit, but it seems very sharp and professio

Re: A documetation suggestion (was Re: Cocoa et al as HCI usability problem)

2008-05-24 Thread Gerriet M. Denkmann
On 25 May 2008, at 03:00, Ken Thomases wrote: On May 24, 2008, at 12:36 AM, Gerriet M. Denkmann wrote: On Fri, May 23, 2008 at 9:19 AM, Gerriet M. Denkmann <[EMAIL PROTECTED]> wrote: So I - entered "disc recording" into Xcode -> Help -> Documentation - nothing at all ...answering abou

Re: A documetation suggestion (was Re: Cocoa et al as HCI usability problem)

2008-05-24 Thread Ken Thomases
On May 24, 2008, at 12:36 AM, Gerriet M. Denkmann wrote: On Fri, May 23, 2008 at 9:19 AM, Gerriet M. Denkmann <[EMAIL PROTECTED]> wrote: So I - entered "disc recording" into Xcode -> Help -> Documentation - nothing at all ...answering about Xcode Version 2.4: I did try both modes (Full-T

Re: A documetation suggestion (was Re: Cocoa et al as HCI usability problem)

2008-05-24 Thread Gerriet M. Denkmann
On 23 May 2008, at 23:18, Shawn Erickson wrote: On Fri, May 23, 2008 at 9:19 AM, Gerriet M. Denkmann <[EMAIL PROTECTED]> wrote: So I - entered "disc recording" into Xcode -> Help -> Documentation - nothing at all ...talking about Xcode 2.5 in the following... Try changing Xcode to searc

Re: A documetation suggestion (was Re: Cocoa et al as HCI usability problem)

2008-05-23 Thread Scott Ribe
> If I > want to do some Cocoa Networking, do I look at Cocoa > Networking, or > Networking > Cocoa? Either. -- Scott Ribe [EMAIL PROTECTED] http://www.killerbytes.com/ (303) 722-0567 voice ___ Cocoa-dev mailing list (Cocoa-dev@lists.apple.com) P

Re: A documetation suggestion (was Re: Cocoa et al as HCI usability problem)

2008-05-23 Thread Steve Weller
The documentation is for the most part oriented around the implementation of the technologies offered (inside out view) rather than the solving of the challenged faced (outside in view). For experts this is no great barrier, because they are already arguably inside. But see how this trips

Re: A documetation suggestion (was Re: Cocoa et al as HCI usability problem)

2008-05-23 Thread Julius Guzy
On 23 May 2008, at 14:14, Steve Weller wrote: On May 23, 2008, at 5:56 AM, Julius Guzy wrote: I have done no analysis of what my learning problems were because I failed to keep a log. All I have to go on so far are vague memories of frustration with Interface Builder primarily but that

Re: A documetation suggestion (was Re: Cocoa et al as HCI usability problem)

2008-05-23 Thread Shawn Erickson
On Fri, May 23, 2008 at 9:19 AM, Gerriet M. Denkmann <[EMAIL PROTECTED]> wrote: > So I > - entered "disc recording" into Xcode -> Help -> Documentation - nothing at > all ...talking about Xcode 2.5 in the following... Try changing Xcode to search documentation by "Full-Text Search" when you aren

Re: A documetation suggestion (was Re: Cocoa et al as HCI usability problem)

2008-05-23 Thread Gerriet M. Denkmann
On 23 May 2008, at 11:49, Ken Thomases wrote: On May 23, 2008, at 3:09 AM, Gerriet M. Denkmann wrote: I do seem to remember that there was something to write files and folders to a CDs using an Objective-C interface. - entered "disk" into AppKido - nothing except NSURLCache. - entered "disk

Re: A documetation suggestion (was Re: Cocoa et al as HCI usability problem)

2008-05-23 Thread Julius Guzy
On 22 May 2008, at 23:19, Scott Anguish wrote: On May 22, 2008, at 10:39 AM, Julius Guzy wrote: On 22 May 2008, at 4:55, David Casseres wrote: That's a really good idea, your wiki-that's-more-than-a-wiki. You're in charge! 8^{) Ha Ha But just as a matter of interest, how would one set

Re: A documetation suggestion (was Re: Cocoa et al as HCI usability problem)

2008-05-23 Thread Ken Thomases
On May 23, 2008, at 3:09 AM, Gerriet M. Denkmann wrote: I do seem to remember that there was something to write files and folders to a CDs using an Objective-C interface. - entered "disk" into AppKido - nothing except NSURLCache. - entered "disk recording" into Xcode -> Help -> Documentation -

Re: A documetation suggestion (was Re: Cocoa et al as HCI usability problem)

2008-05-23 Thread Gerriet M. Denkmann
On 23 May 2008, at 08:54, Scott Anguish wrote: On May 23, 2008, at 2:23 AM, Gerriet M. Denkmann wrote: 1. For me the documentation would be very hard to use without the excellent AppKiDo. 2. It really should be Apple's job to provide something like AppKiDo. There is new browsing facilit

Re: A documetation suggestion (was Re: Cocoa et al as HCI usability problem)

2008-05-22 Thread Scott Anguish
On May 23, 2008, at 2:23 AM, Gerriet M. Denkmann wrote: 1. For me the documentation would be very hard to use without the excellent AppKiDo. 2. It really should be Apple's job to provide something like AppKiDo. There is new browsing facilities in Xcode 3.0. Research Assistant, and the

Re: A documetation suggestion (was Re: Cocoa et al as HCI usability problem)

2008-05-22 Thread Gerriet M. Denkmann
On 23 May 2008, at 01:38, [EMAIL PROTECTED] wrote: On May 22, 2008, at 11:15 AM, Jonathan Hendry wrote: Perhaps a better way of doing this would be a web or WebKit app with two panes. One that shows the Apple docs at Apple's site, and the other pane points to a page at a non-Apple wiki site t

Re: A documetation suggestion (was Re: Cocoa et al as HCI usability problem)

2008-05-22 Thread Andy Lee
On May 22, 2008, at 6:22 PM, Scott Anguish wrote: On May 22, 2008, at 11:15 AM, Jonathan Hendry wrote: Perhaps a better way of doing this would be a web or WebKit app with two panes. One that shows the Apple docs at Apple's site, and the other pane points to a page at a non-Apple wiki site t

Re: A documetation suggestion (was Re: Cocoa et al as HCI usability problem)

2008-05-22 Thread Scott Anguish
On May 22, 2008, at 11:15 AM, Jonathan Hendry wrote: Perhaps a better way of doing this would be a web or WebKit app with two panes. One that shows the Apple docs at Apple's site, and the other pane points to a page at a non-Apple wiki site that corresponds to the currently displayed Apple

Re: A documetation suggestion (was Re: Cocoa et al as HCI usability problem)

2008-05-22 Thread Scott Anguish
On May 22, 2008, at 10:39 AM, Julius Guzy wrote: On 22 May 2008, at 4:55, David Casseres wrote: That's a really good idea, your wiki-that's-more-than-a-wiki. You're in charge! 8^{) Ha Ha But just as a matter of interest, how would one set about talking to apple about such a thing? I wo

Re: A documetation suggestion (was Re: Cocoa et al as HCI usability problem)

2008-05-22 Thread Jonathan Hendry
Perhaps a better way of doing this would be a web or WebKit app with two panes. One that shows the Apple docs at Apple's site, and the other pane points to a page at a non-Apple wiki site that corresponds to the currently displayed Apple site. That would ensure that the Apple content stays

Re: A documetation suggestion (was Re: Cocoa et al as HCI usability problem)

2008-05-22 Thread Julius Guzy
On 22 May 2008, at 4:55, David Casseres wrote: That's a really good idea, your wiki-that's-more-than-a-wiki. You're in charge! 8^{) Ha Ha But just as a matter of interest, how would one set about talking to apple about such a thing? I would guess one would need first to demonstrate some

Re: A documetation suggestion (was Re: Cocoa et al as HCI usability problem)

2008-05-21 Thread David Casseres
That's a really good idea, your wiki-that's-more-than-a-wiki. You're in charge! 8^{) On May 19, 2008, at 5:31 AM, Julius Guzy wrote: Well I never thought I would cause this much discussion. I have tried but do not have the time needed to reply to all. I might still but work must take precede

A documetation suggestion (was Re: Cocoa et al as HCI usability problem)

2008-05-19 Thread Julius Guzy
Well I never thought I would cause this much discussion. I have tried but do not have the time needed to reply to all. I might still but work must take precedence. There have been a number of people who suggested I give specific instances of documentation failure. I agree it would be useful bu