• 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: "I. Savant" <email@hidden>
  • Date: Mon, 4 Aug 2008 08:42:56 -0400

On Mon, Aug 4, 2008 at 8:26 AM, Allison Newman <email@hidden> wrote:
> Following on from my previous message, a few months back, we had a long discussion on this list about whether the documentation was of a good quality or not.  This is an example where I find myself completely unable to find the documentation that I need to answer the question myself.  If anyone can give me a tip as to how I should have searched to get the answer myself without having to bother this list, that would be greatly appreciated as well :-)

  It's kind of hard to do so for those who weren't following your
thread without at least posting a link to your previous message *or*
summarizing your point in this thread.

> More generally on the topic of documentation, this is the typical kind of problem where I find that the documentation fails - when you don't have a clue as to what sort of API might be responsible, the documentation is quite poor for enabling you to discover the API by yourself. Poor discoverabilty...

  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.

--
I.S.
_______________________________________________

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:
    • Re: Documentation
      • From: "I. Savant" <email@hidden>
    • Re: Documentation
      • From: Allison Newman <email@hidden>
    • Re: Documentation
      • From: Allison Newman <email@hidden>
References: 
 >Documentation (From: Allison Newman <email@hidden>)

  • Prev by Date: Documentation
  • Next by Date: Re: How to get music list?
  • Previous by thread: Documentation
  • Next by thread: Re: Documentation
  • Index(es):
    • Date
    • Thread