WSDL 2.0 Primer - remaining work

Per our action item:
http://www.w3.org/2005/01/19-ws-desc-minutes.html#ActionSummary
[[
ACTION: dbooth and KevinL to scope remaining primer work and
... identify who needs to supply what advanced topic sections
]]

Current editor's copy of the primer:
http://dev.w3.org/cvsweb/~checkout~/2002/ws/desc/wsdl20/wsdl20-primer.html

Here is a list of remaining work on the WSDL Primer that needs input
from others in the WG.  (Remaining work items that only involve the
primer editors are not included in this list.)

1. Section 2.5.1
Clarification needed: Part 3 sec 2.8.1 and 2.8.2: soap fault codes
See
http://lists.w3.org/Archives/Public/public-ws-desc-comments/2004Dec/0003.html

2. Section 7.2 Features and Properties:
[Pending resolution of the formal objection to F&P]
Incorporate material from
http://lists.w3.org/Archives/Public/www-ws-desc/2003Oct/0144.html
and make sure examples are correct.

3. Section 7.3 Import mechanism and authoring style:
Add material discussing how WSDL documents should be factored to allow
significant components to be reused.

4. Section 7.4 Multiple Logical WSDL Documents Describing the Same
Service:
[Pending the resolution of the proposal to allow multiple interfaces per
service]
Add material acknowledging that multiple logical WSDL documents might
try to describe the same service. Explain why some might do this
intentionally, why it might cause problems for some systems, and explain
that this is outside scope of the WSDL language. See thread starting at
http://lists.w3.org/Archives/Public/www-ws-desc/2003Dec/0045.html

5. Section 7.5 Versioning and Service Equivalency:
Add material.  
See also
http://lists.w3.org/Archives/Public/www-ws-desc/2003Dec/0047.html
Per decision 2004-03-04 to add the results of the Versioning Task Force
also.

6. Section 7.6 MTOM Support:
Add material to show how Features and Properties can be used to indicate
the use of MTOM.   See example from GlenD:
http://lists.w3.org/Archives/Public/www-ws-desc/2004May/0076.html
Also add material to show how to do it without using F&P?

7. Section 7.7 Security Considerations:
Write this section or delete it.

8. Section 7.8 Operation Style and RPC:
Write this section, with an example.

9. Section 7.11 Service References:
Add explanation and example.  Use
http://lists.w3.org/Archives/Public/www-ws-desc/2003Oct/0345.html as a
starting point. Also example(s) from Roberto per the resolution at the
end of http://lists.w3.org/Archives/Public/www-ws-desc/2003Nov/0061.html

10. Section 7.12 XML Schema Examples:
Review, edit and add Paul Downey's contribution at
http://lists.w3.org/Archives/Public/www-ws-desc/2004May/0007.html

11. Section 7.13 Multiple In-Line Schemas:
[Pending resolution of the question about multiple inline schemas.]
Add material explaning that this can be done. See
http://lists.w3.org/Archives/Public/www-ws-desc/2003Nov/0109.html
http://lists.w3.org/Archives/Public/www-ws-desc/2003Nov/0126.html
http://lists.w3.org/Archives/Public/www-ws-desc/2003Nov/0130.html

12. Section 7.14 The schemaLocation Attribute:
Add material and example.
See discussion in
http://lists.w3.org/Archives/Public/www-ws-desc/2003Nov/0135.html and
thread called "Schemas in imported WSDL" in
http://lists.w3.org/Archives/Public/www-ws-desc/2003Nov/thread.html

13. Section 7.15 Mapping to RDF and Semantic Web:
Add this section.  (Awaiting RDF mapping)

-- 

David Booth
W3C Fellow / Hewlett-Packard

Received on Wednesday, 2 February 2005 21:57:24 UTC