RA WD Spec Issues

Hi all,
We have been reviewing the five working drafts, and while this will be an on-going process over the course of the coming week, in the interests of having information in a timely manner, we are providing feedback as early as possible.  So far we have only carefully evaluated the Eventing spec, but a number of comments below will apply to all other specs.  We are assuming it is best to send these WD issues to the mailing list rather than enter each in bugzilla, although we have not seen others submit WD issues yet.  Are others also reviewing these specs?
Hope this helps,
Geoff


Eventing spec and some more general Issues

1.      The link for "This version" (http://www.w3.org/WS-RA/WS-Eventing/20090121) does not resolve.  Is the link correct?

2.      The Working Draft Date says "21 January 2009" - should say XX February 2009.

3.      In the status section of each spec, there should be a statement that explains the intent of this working draft.  Perhaps something along the lines of:  This working draft is meant only as a direct translation of the submitted spec into W3C format.  There are many issues in the working group that will cause changes to this draft.  Please see working group issue list<http://www.w3.org/Bugs/Public/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=WS-Resource+Access&long_desc_type=allwordssubstr&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&status_whiteboard_type=allwordssub>.

4.      There should be mention in the status section that the acknowledgement section is yet to be updated.

5.      It would appear that the public archive link in the status section of each spec is not correct.

6.      In the status section, it says:

"This is a draft document and may be updated, replaced or obsoleted by other documents at any time."

Not sure if obsoleted is actually a word, suggest:

"This is a draft document and may be updated, replaced or made obsolete by other documents at any time."

7.      In the XML namespaces section, at the bottom, there is a spelling mistake: "implementationc" should be "implementations" - probably in all specs.

8.      Eventing, section 2.2 "http://www.w3.org/2009/02/ws-evt/DeliveryModes/Wrap" needs to resolve to something

9.      Eventing section 4.2 - the link "4.1 Subscribe <http://www.w3.org/2002/ws/ra/edcopies/wseventing-wd1.html#Subscribe> " has an extra space in it at the end.  This happens in both occurrences in this section.

10.   Eventing section 4.3 - the 2 links "4.2 Renew <http://www.w3.org/2002/ws/ra/edcopies/wseventing-wd1.html#Renew> " have an extra space in them.

11.   Eventing section 4.4 - the link "4.2 Renew <http://www.w3.org/2002/ws/ra/edcopies/wseventing-wd1.html#Renew> " has an extra space.

12.   Eventing section 4.5 - extra space in "4.1 Subscribe <http://www.w3.org/2002/ws/ra/edcopies/wseventing-wd1.html#Subscribe> " also period inside of ")" instead of outside.

13.   Eventing Appendix B says:

"A normative copy of the XML Schema [XML Schema, Part 1]<http://www.w3.org/2002/ws/ra/edcopies/wseventing-wd1.html#XMLSchema1> , [XML Schema, Part 2]<http://www.w3.org/2002/ws/ra/edcopies/wseventing-wd1.html#XMLSchema2> for this specification may be retrieved by resolving the XML namespace URI for this specification (listed in 3.2 XML Namespaces <http://www.w3.org/2002/ws/ra/edcopies/wseventing-wd1.html#namespaces> )."

Will that be true?  What will be resolved at: http://www.w3.org/2009/02/ws-evt ?

We hope it will resolve to the actual namespace document.

We also hope that some link will be available that resolves to the schema document.

Note also extra space in link name.

14.   Eventing Appendix C says:

"A normative copy of the WSDL [WSDL 1.1]<http://www.w3.org/2002/ws/ra/edcopies/wseventing-wd1.html#WSDL11> description can be retrieved from the following address:

http://www.w3.org/2009/02/ws-evt/eventing.wsdl

Is that true?  We hope it will resolve to the actual WSDL document.

Received on Wednesday, 11 February 2009 21:59:38 UTC