• 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: Bill Nalen <email@hidden>
  • Date: Mon, 4 Jul 2005 23:00:35 -0400


On Jul 4, 2005, at 9:13 PM, Andy O'Meara wrote:


Some of your points may hold a bit, but it doesn't seem like you've given
Apple's sample code db a fair shake -- there's a landslide of great,
reusable sample code on ADC. If you're new to it, use have the ADC be your
starting point for everything (http://developer.apple.com/).

Sorry, I just assumed that the documentation would be adequate from within Xcode, and I thought it was a copy of what was available from the web site. I'll check there first next time.


At ADC, they
have at least one sample project for every possible suite and all their
example projects are usually pretty complete (not just one page of code that
is worthless). Granted, I could be suffering from a distortion field, but

I'm not sure what you mean by "every possible suite". You mean they try to give examples for each api function?


I guess the biggest annoyance I have is that when I drill down one level, I'm presented with a list of articles by date. Date is the least likely thing I could want this list sorted by. For instance:

http://developer.apple.com/samplecode/Carbon/idxGraphicsImaging- date.html

I'd much rather see that list group by OpenGL, Quartz, basic drawing, etc. Things I'd want to sort on most are category, topic, basic/ advanced.

Thanks
Bill


_______________________________________________ Do not post admin requests to the list. They will be ignored. Xcode-users mailing list (email@hidden) Help/Unsubscribe/Update your Subscription: This email sent to email@hidden
References: 
 >Re: Documentation frustrations (From: "Andy O'Meara" <email@hidden>)

  • Prev by Date: Re: Cross-platform & Cross-SDK
  • Next by Date: Re: Documentation frustrations
  • Previous by thread: Re: Documentation frustrations
  • Next by thread: Re: Documentation frustrations
  • Index(es):
    • Date
    • Thread