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

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

From: Karl Dubost <karl@w3.org>
Date: Thu, 19 Oct 2006 16:10:30 +0900
Message-Id: <296F16CD-E730-49B3-9A46-62A9203BDC03@w3.org>
To: public-ws-chor-comments@w3.org

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 07:12:56 GMT

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