• 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
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Documentation


  • Subject: Re: Documentation
  • From: Allison Newman <email@hidden>
  • Date: Mon, 04 Aug 2008 15:00:37 +0200

On Monday, August 04, 2008, at 02:42PM, "I. Savant" <email@hidden> wrote:
>  I think the long on-list discussion(s) you mentioned about the
>documentation kept pointing back to the feedback mechanism. This isn't
>really the place to complain if you expect results. Post feedback,
>contact DTS, et cetera. Posting it on-list really only amounts to
>noise, since everyone has their opinions and it's pretty clear those
>opinions are evenly polarized.
>

During the discussion there were numerous people that felt that the documentation was just fine the way it was, and they wanted explicit examples of where the documentation failed.  At the time I couldn't remember any specific examples, but I know that I quite often feel frustrated by the documentation.  So I decided that the next time I had a good example, I would post it to the list, along with a request for how other people use the documentation to figure out the answer for themselves.

Frankly, I think asking other Cocoa programmers about how to use the Cocoa documentation effectively, using a specific example to examine the question, is a perfectly legitimate use of the Cocoa Developer's list - I certainly don't appreciate you appointing yourself high judge of what is and isn't appropriate.
_______________________________________________

Cocoa-dev mailing list (email@hidden)

Please do not post admin requests or moderator comments to the list.
Contact the moderators at cocoa-dev-admins(at)lists.apple.com

Help/Unsubscribe/Update your Subscription:

This email sent to email@hidden

  • Follow-Ups:
    • [moderator] Re: Documentation
      • From: Scott Anguish <email@hidden>
    • Re: Documentation
      • From: "I. Savant" <email@hidden>
References: 
 >Documentation (From: Allison Newman <email@hidden>)
 >Re: Documentation (From: "I. Savant" <email@hidden>)

  • Prev by Date: Re: Instance vars, local vars and speed
  • Next by Date: Re: Documentation
  • Previous by thread: Re: Documentation
  • Next by thread: Re: Documentation
  • Index(es):
    • Date
    • Thread