Re: why are there zero examples in the cocoa docs?!

FROM : mmalc crawford
DATE : Sun Jan 20 18:32:27 2008

On Jan 19, 2008, at 11:47 AM, Joeles Baker wrote:

> why does the documentation suck so much (for beginners)? :-)
> am i researching the wrong place?
> when looking at for example the php documentation, every method has 
> at least a nice syntax sample...
> when reading the cocoa doc, i have something like this:
> addChapters
> Adds chapters to the receiver using the information specified in the 
> chapters array.
> - (void)addChapters:(NSArray *)chapters withAttributes:(NSDictionary 
> *)attributes error:(NSError **)errorPtr
>

Another aspect to this is that QTKit is not a "core" Cocoa framework. 
There are likely to be fewer examples of *basic* techniques than in, 
say, Foundation or AppKit.

The subject line notwithstanding, there *are* many examples in the 
documentation -- even in the API reference.  One of the most extreme 
examples perhaps is given in NSMutableArray:
<http://developer.apple.com/documentation/Cocoa/Reference/Foundation/Classes/NSMutableArray_Class/Reference/Reference.html#//apple_ref/occ/instm/NSMutableArray/insertObjects:atIndexes:
>

mmalc