W3C home > Mailing lists > Public > public-ws-chor-comments@w3.org > October 2006

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

From: Steve Ross-Talbot <steve@pi4tech.com>
Date: Thu, 19 Oct 2006 11:38:37 +0100
Message-Id: <36DE204E-8455-40D3-A531-A176836B1C63@pi4tech.com>
Cc: public-ws-chor-comments@w3.org
To: Karl Dubost <karl@w3.org>

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 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Tuesday, 8 January 2008 14:20:10 GMT