Re: The challenge for Cocoa's on-line documentation

2008-05-18 Thread Scott Anguish
bindings is discussed in the Cocoa Bindings Reference the UI settings alone don't take into account all the usage patterns. although there is no question that documentation could always be better (and that's coming from someone in techpubs). On May 17, 2008, at 4:16 PM, Johnny Lundy wrote:

Re: The challenge for Cocoa's on-line documentation

2008-05-17 Thread Johnny Lundy
at the documentation for NSDatePicker if you want to see how NOT to write documentation. On May 17, 2008, at 9:17 AM, [EMAIL PROTECTED] wrote: Re: The challenge for Cocoa's on-line documentation ___ Cocoa-dev mailing list (Cocoa-dev@lists.apple.com

Re: The challenge for Cocoa's on-line documentation

2008-05-17 Thread Jeff LaMarche
On May 17, 2008, at 4:16 PM, Johnny Lundy wrote: I never had any problem with a language's documentation since 1970 with the IBM 360 Reference Manual. That is, until I came across Apple's documentation of Cocoa. I have never been so frustrated in my life. snip The usual pattern for a User

Re: The challenge for Cocoa's on-line documentation

2008-05-17 Thread Gary L. Wade
Johnny Lundy wrote: Try looking at the documentation for NSDatePicker if you want to see how NOT to write documentation. Uh, are you talking about THIS web page? http://developer.apple.com/documentation/Cocoa/Reference/ApplicationKit/Classes/NSDatePicker_Class/Reference/Reference.html I

Re: The challenge for Cocoa's on-line documentation

2008-05-17 Thread Uli Kusterer
Am 17.05.2008 um 23:42 schrieb Gary L. Wade: I haven't ever used this class, but from just looking it over quickly, it seems like it's pretty easy to figure everything out. If you have a problem, just click on the links (e.g., NSDatePickerStyle). While I think the docs aren't as bad as

The challenge for Cocoa's on-line documentation

2008-05-17 Thread Klaus Backert
Johnny Lundy wrote: I never had any problem with a language's documentation since 1970 with the IBM 360 Reference Manual. That is, until I came across Apple's documentation of Cocoa. I have never been so frustrated in my life. - Everything is defined in terms of something else. -

Re: The challenge for Cocoa's on-line documentation

2008-05-16 Thread Andy Lee
On May 16, 2008, at 5:05 PM, Erik Buck wrote: [Re-post from http://www.cocoabuilder.com/archive/message/cocoa/2007/8/20/188026 ] That was well worth reposting. This may partly answer my question about why people don't notice or study the concepts docs. Maybe we're too used to clicking on

Re: The challenge for Cocoa's on-line documentation

2008-05-16 Thread Kevin Grant
Wikis like CocoaDev can be nice for filling these gaps. I find it helpful to see not only the articles, which are usually practical, but also visitor comments. For example, someone can easily add a statement to a 4-year-old page, pointing out a new approach that works better. Or, a debate can

Re: The challenge for Cocoa's on-line documentation

2008-05-16 Thread Gustavo Eulalio
Very good post, Erik. Here's what I feel now about this issue. I too am having difficulties to learn Cocoa. The problem might be that I'm new to both Cocoa and Objective C. I've seen some tutorials that try to teach them at the same time. I'm afraid they might be a little too shallow, exploring