- From: Karl Dubost <karl@w3.org>
- Date: Thu, 19 Oct 2006 16:10:30 +0900
- 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 UTC