Date: Tue, 27 May 2008 16:48:23 -0400
From: Andy Lee <[EMAIL PROTECTED]>
On May 27, 2008, at 4:15 PM, Peter Duniho wrote:
Date: Tue, 27 May 2008 14:57:09 -0400
From: Andy Lee <[EMAIL PROTECTED]>
Also, when we *do* ask to see people's code (which also happens),
it's
not because the code is the best way to express their intentions.
It's because their code is not *fulfilling* their intentions.
Not at
all the same as code snippets in documentation.
Au contraire!
You are making the incorrect assumption that the documentation does
a 100% correct job of conveying intentions to every person who may
read it.
I have no idea where you get this.
My apologies if I've misinterpreted what you wrote. I certainly know
how that feels.
My response was based on the synthesis of the points to which you
were responding and your own statement that the scenario of using
code as a communications tool when people are asking questions is
"not at all the same as code snippets in documentation".
If you agree with me that the documentation can in fact benefit from
the use of code snippets as a form of elaboration in the API
reference, then obviously I misunderstood.
Pete
_______________________________________________
Cocoa-dev mailing list (Cocoa-dev@lists.apple.com)
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:
http://lists.apple.com/mailman/options/cocoa-dev/archive%40mail-archive.com
This email sent to [EMAIL PROTECTED]
