Re: running an external app

FROM : Peter Duniho
DATE : Tue May 27 23:37:12 2008

> Date: Tue, 27 May 2008 16:48:23 -0400
> From: Andy Lee <<email_removed>>
>
> On May 27, 2008, at 4:15 PM, Peter Duniho wrote:

>>> Date: Tue, 27 May 2008 14:57:09 -0400
>>> From: Andy Lee <<email_removed>>
>>>
>>> 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