W3C home > Mailing lists > Public > www-ws-desc@w3.org > October 2003

RE: examples in spec?

From: Tom Jordahl <tomj@macromedia.com>
Date: Fri, 3 Oct 2003 11:10:26 -0400
Message-ID: <CB1FF0A474AEA84EA0206D5B05F6A4CB03C2ED4C@S1001EXM02.macromedia.com>
To: 'Arthur Ryman' <ryman@ca.ibm.com>, Jean-Jacques Moreau <jean-jacques.moreau@crf.canon.fr>
Cc: Sanjiva Weerawarana <sanjiva@watson.ibm.com>, www-ws-desc@w3.org
+1
 
I am very syntax oriented - show me the angle brackets and I will think the spec is comprehensible.  Otherwise it will be a bunch of mumbo-jumbo about an "abstract component model" or something.
 
--
Tom Jordahl
Macromedia
 
-----Original Message-----
From: Arthur Ryman [mailto:ryman@ca.ibm.com]
Sent: Friday, October 03, 2003 8:43 AM
To: Jean-Jacques Moreau
Cc: Sanjiva Weerawarana; www-ws-desc@w3.org; www-ws-desc-request@w3.org
Subject: Re: examples in spec?



I find illustrative examples very helpful in understanding specs. I think the spec should contain short examples for each construct. The spec should be self-contained, i.e. not require you to refer to the primer. The primer should contain an extended example and perhaps clarify subtle features.

Arthur Ryman 



	"Jean-Jacques Moreau" <jean-jacques.moreau@crf.canon.fr> 
Sent by: www-ws-desc-request@w3.org 


10/03/2003 05:29 AM 


        
        To:        Sanjiva Weerawarana <sanjiva@watson.ibm.com> 
        cc:        www-ws-desc@w3.org 
        Subject:        Re: examples in spec? 





My recollection is that most examples would be in the primer, Part 1 & 3 
containing only a small number of introductory examples.

JJ.

Sanjiva Weerawarana wrote:

> I remember we discussed the idea of including some examples
> (more likely example fragments) in the spec(s). What was the
> final verdict?
> 
> Sanjiva.
> 
> 
Received on Friday, 3 October 2003 11:10:30 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Monday, 7 December 2009 10:58:27 GMT