Re: Documentation frustrations
Re: Documentation frustrations
- Subject: Re: Documentation frustrations
- From: mmalcolm crawford <email@hidden>
- Date: Fri, 8 Jul 2005 23:21:14 -0700
On Jul 8, 2005, at 11:12 PM, Raffael Cavallaro wrote:
On Jul 9, 2005, at Sat, Jul 9, 1:32 48 AM, mmalcolm crawford wrote:
It would also have sample code embedded in it.
Again, it does to a reasonable and limited extent.
I would rather characterize this as "an unreasonably limited extent."
It's not really helpful if you simply repeat the complaint. What
would be helpful would be if you gave concrete examples.
If you find places where you believe the API reference would
benefit from code samples, please file enhancement requests.
I would have to file enhancement requests for most of the API
references - sample code in the API references is as scarce as
water in a desert.
(a) This is simply untrue. It does not help the case if you make
inaccurate statements (or, regarding other issues, indulge in
baseless speculation).
(b) If you don't file bug reports, then it's certainly not going to
be fixed.
And again it would be interesting if you could provide an outline
for the NSView drawRect: method.
I don't follow you here - is this intended to be sarcastic because
NSView is an abstract class?
No, it's because it's a good example of a case where simply giving a
code sample in isolation is unlikely to be useful. I would be very
interested to know how you would approach the issue.
mmalc
_______________________________________________
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