FROM : mmalc crawford
DATE : Sun Jan 20 12:11:00 2008
On Jan 20, 2008, at 2:20 AM, Ren� v Amerongen wrote:
> Then it would be nice to have in the reference references ( link )
> to the accompanying conceptual doc.
>
They typically do, at the top of each reference -- see "Companion
guides" in, for example, <http://developer.apple.com/documentation/Cocoa/Reference/Foundation/Classes/NSString_Class/Reference/NSString.html
>.
If there's no companion guide listed, it means there's either no
conceptual material or the link hasn't been established yet. In such
a case, it's probably worth doing a full-text search for the class/
symbol you're interested in and seeing if it is described in a
conceptual document. If it is not, then file an enhancement request
for it to be written; if it is, then file a bug stating that the link
is missing.
mmalc
