W3C home > Mailing lists > Public > public-ws-chor-comments@w3.org > May 2004

Examples in the CDL specification and the Primer

From: Tony Fletcher <tony_fletcher@btopenworld.com>
Date: Mon, 24 May 2004 15:36:50 +0100
To: <public-ws-chor-comments@w3.org>
Message-ID: <003001c4419c$8e160d50$6401a8c0@corp.choreology.com>
The current version of the CDL specification
http://www.w3.org/TR/2004/WD-ws-cdl-10-20040427/	  has an empty
section for an example.
 
I think it is right and proper to have example fragments to accompany each
significant item in the specification to illustrate the correct use of the
syntax and its meaning (and perhaps also to warn against potential mis-use
or mis-application).  It would also be very helpful to have a complete,
though relatively straightforward example to illustrate a complete
description.  I suggest this is added as an Appendix rather than a main
section.
 
The primer could take the structure of developing from scratch, and a stated
scenario, a complete example description.
 
I suggest that the primer is aimed at two complementary functions.
Firstly illustrating how to develop a complete description from first
principles as the group started to do in the 11-13 May 2004 face to face
meeting.
Secondly providing guidance and illustrative uses of all the language
features - elements, attributes and functions, and anything else of
importance.  This may necessitate some extra example fragments over and
above the main example (as the main example should not be made more
complicated or contorted than necessary just to squeeze everything into it.
 
Best Regards     Tony
A M Fletcher
 
Cohesions  (TM)
 
Business transaction management software for application coordination
www.choreology.com <http://www.choreology.com/> 
 
Choreology Ltd., 68 Lombard Street, London EC3V 9LJ     UK
Tel: +44 (0) 1473 729537   Fax: +44 (0) 870 7390077  Mobile: +44 (0) 7801
948219
tony.fletcher@choreology.com     (Home: amfletcher@iee.org)
 
Received on Monday, 24 May 2004 10:37:28 GMT

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