RE: plan for primer examples

Hi David,

Let's see how the examples best fit into different primer sections when I have the first draft.

As a general comment, now I think we should try best to make our primer cover the specs as complete as possible, instead of  just covering the "main" portion of the spec and leaving "advanced" topics out. (doesn't mean we have to literally provide an "Advanced Topics" section. Advanced topics may be mixed in the main body ). After our discussion last week, now we most likely will have Z-ed notatin in the spec. While I agree the group has a reason to include each of the three layers, I find it not hard to image that, with all the layers and mappings in the specs, more readers will get intimidated after a few pages and will turn to the primer quickly for understanding the spec. If the primer only covers a part of the spec, it will not benefit the readers too much. 

I heard a lot of good comments for the XML schema spec, and would like to suggest that we model after it.

Best Regards,
Kevin
 

-----Original Message-----
From: www-ws-desc-request@w3.org [mailto:www-ws-desc-request@w3.org] On Behalf Of David Booth
Sent: Friday, Oct 01, 2004 01:22 PM
To: Liu, Kevin
Cc: 'Jonathan Marsh'; www-ws-desc@w3.org
Subject: Re: plan for primer examples



On Fri, 2004-10-01 at 13:03, Liu, Kevin wrote:
> Hi David and all,
>  
> Based on our discussion in the Toronto F2F, here is some examples I am
> thinking to rewrite/add for the primer. Please let me know if you
> would like to see something more or different. Concrete suggestions
> will be highly appreciated.
>  
> Introduction
>     - a simple complete example for the hotel service (aggregate the
> pieces in the current draft)

Yes!  That would be very helpful, so that somebody can just copy and
paste it to try it, or they could use it as a template for
experimentation.

Regarding the others below, they all seem useful.  However, I think the
main issue is that they may be too long to include in the main body of
the Primer.  I.e., having them in the main body may disrupt the flow of
the Primer too much.  I would suggest having them in an appendix of the
Primer, referenced from the body.  


>  
> Interface section
>    -  an example of using xsd import, including the cases for intra
> schema references within the same <types> section
>    -  an example of using interface inheritance
>     - an example of using RPC style
>    - an example of  defining reusable faults
>  
> Binding section
>     - an example of soap1.2 binding (extended from the complete
> example in the begining)
>     - an example of soap1.1 binding (for the same interface, pending
> on the work of soap1.1 binding)
>     - an example of http binding (for the same interface)
>     - an example of binding fault 
>  
> Service
>     - (reuse the complete example in the beginning)
>  
> Advanced
>     - example of using wsdl import and include
>     - example of using media type and MTOM for attachment support
>     - example of defining headers uisng application data feature
> (optional)
> 
> Best Regards,
> Kevin
>  
> 
>  
-- 

David Booth
W3C Fellow / Hewlett-Packard

Received on Monday, 4 October 2004 16:48:03 UTC