Re: examples in spec?

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 UTC