Re: Documentation frustrations
Re: Documentation frustrations
- Subject: Re: Documentation frustrations
- From: Stéphane Sudre <email@hidden>
- Date: Sun, 10 Jul 2005 00:06:18 +0200
* Some suggestions regarding documentations:
o As I have found that it is easier to ask to remove a feature than to
fix it:
Please, remove all sample code from the Cocoa documentation.
Reason: the provided sample code is old and sometimes buggy (Cf the
supposed equivalent of a modal session which is either incomplete or
completely wrong).
o The documentation is currently stating how a method is supposed to
work. What I would like to see is information on what it was doing
incorrectly in specific releases:
There has been bugs in Cocoa APIs. These bugs are either listed in the
Release Notes or not listed. It would be interested to have for every
single method a link to the bugs in the method and in which OS releases
the bug was and in which OS release, the bug was fixed.
For instance, it would have avoided the move with Xcode 2.1 to have
10.2 archiving format as the default nib file format.
From the email@hidden archives:
---------8<-----------8<------------8<-----------
http://www.cocoabuilder.com/archive/message/2002/12/9/53287
On Sunday, December 8, 2002, at 03:28 PM, Vince DeMarco wrote:
>
>> There are bugs with the Custom Class stuff in IB and the new Keyed
>> archiver. The easiest solution is to not use Keyed archiving until
>> this bug gets fixed in Foundation.
---------8<-----------8<------------8<-----------
This basically means that Xcode 2.1 is using an incompatible format if
you want 10.2 compatibility. And there is not the least warning about
this in Xcode, in the documentation, in Interface Builder.
_______________________________________________
Do not post admin requests to the list. They will be ignored.
Cocoa-dev mailing list (email@hidden)
Help/Unsubscribe/Update your Subscription:
This email sent to email@hidden