Re: [ws-cdl-10-primer] a simpler Primer

I completely agree and will work towards a simple explanation.

Thanks for the feedback.


Cheers

Steve T

On 19 Oct 2006, at 08:10, Karl Dubost wrote:

>
> About Web Services Choreography Description Language: Primer
> W3C Working Draft 19 June 2006
>
>
> The overview is still too hardcore. It would be better for the  
> reader that the first sections about the technology are  
> understandable by almost any adults. Steve Ross-Talbot introduced  
> Choregraphy in the past with a Jazz band, It was an excellent idea.  
> It was clear and simple, and was giving the main structure of the  
> technology. After this metaphor it will be a lot easier to guide  
> the reader to the technology itself.
> http://www.w3.org/TR/2006/WD-ws-cdl-10-primer-20060619/#overview
>
> The introduction of the specification itself is clearer than the  
> start of the Primer.
> http://www.w3.org/TR/ws-cdl-10/#Introduction
>
> There is a problem.
> Please, make the beginning of the Primer really understandable by  
> anyone. A way maybe to achieve this is to think about your wife,  
> husband, child and explain the technology. Then gradually, move to  
> something more complex.
>
> It is the opportunity to explain what were the problems, what the  
> technology will solve and how, to put that in a narrative context,  
> etc.
>
>
>
> -- 
> Karl Dubost - http://www.w3.org/People/karl/
> W3C Conformance Manager, QA Activity Lead
>   QA Weblog - http://www.w3.org/QA/
>      *** Be Strict To Be Cool ***
>
>
>
>
>
>

Received on Thursday, 19 October 2006 10:40:02 UTC