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

Re: examples in spec?

From: Jean-Jacques Moreau <jean-jacques.moreau@crf.canon.fr>
Date: Fri, 03 Oct 2003 18:20:16 +0200
Message-ID: <3F7DA1C0.1000403@crf.canon.fr>
Cc: sanjiva@watson.ibm.com, www-ws-desc@w3.org

Before this gets out of hand, I am *not* opposed to having examples in 
the spec!

JJ.

paul.downey@bt.com wrote:

> +1
>  
> show me the angle brackets!
>  
> and when describing MEPs i'd like some use case diagrams in UML (or 
> whatever)
>  
> --
> Paul Downey
> 
>     -----Original Message-----
>     *From:* Tom Jordahl [mailto:tomj@macromedia.com]
>     *Sent:* 03 October 2003 16:10
>     *To:* 'Arthur Ryman'; Jean-Jacques Moreau
>     *Cc:* Sanjiva Weerawarana; www-ws-desc@w3.org
>     *Subject:* RE: examples in spec?
> 
>     +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 12:20:23 GMT

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