• Open Menu Close Menu
  • Apple
  • Shopping Bag
  • Apple
  • Mac
  • iPad
  • iPhone
  • Watch
  • TV
  • Music
  • Support
  • Search apple.com
  • Shopping Bag

Lists

Open Menu Close Menu
  • Terms and Conditions
  • Lists hosted on this site
  • Email the Postmaster
  • Tips for posting to public mailing lists
Re: Documentation frustrations
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

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
References: 
 >Re: Documentation frustrations (From: Dietmar Planitzer <email@hidden>)

  • Prev by Date: Re: IBOutlet SEL?
  • Next by Date: Re: Documentation frustrations
  • Previous by thread: Re: Documentation frustrations
  • Next by thread: Re: Documentation frustrations
  • Index(es):
    • Date
    • Thread