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:

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. - Interfa

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 s

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 haven

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. The usual pattern for a User Guide

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

2008-05-17 Thread Johnny Lundy
nly I knew what a tag was Try looking 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 ___

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 s

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 b

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 s

The challenge for Cocoa's on-line documentation

2008-05-16 Thread Erik Buck
The potential audience for a computer programming documentation can range from beginner's who don't know what a compiler is to people who are experts themselves and just want a quick reference. Beginners are frustrated when prerequisite knowledge is assumed, and experts are frustrated when they