RE: Updated Primer for Editors and Chairs Sanity Check

Thanks for taking up this work.  Unfortunately I don't think we are quite done yet.

1. Old comment

My comment about incorrect References does not appear to have been fixed:


20. Appendix C. References



[WS-Addressing Policy]

Web Services Addressing 1.0 - WSDL Binding<http://www.w3.org/TR/2006/CR-ws-addr-wsdl-20060529/>, M. Gudgin, M. Hadley, T. Rogers and Ü. Yalçinalp, Editors. World Wide Web Consortium, 29 May 2006. This version of the Web Services Addressing 1.0 - WSDL Binding is http://www.w3.org/TR/2006/CR-ws-addr-wsdl-20060529/. The latest version of Web Services Addressing 1.0 - WSDL Binding<http://www.w3.org/TR/ws-addr-wsdl> is available at http://www.w3.org/TR/ws-addr-wsdl.



The short name of this reference should be [WS-Addressing WSDL Binding].  Change here and where it is used.


[Web Services Policy Framework]

Web Services Policy 1.5 - Framework<http://dev.w3.org/cvsweb/~checkout~/2006/ws/policy/ws-policy-framework.html>, A. S. Vedamuthu, D. Orchard, M. Hondo, T. Boubez and P. Yendluri, Editors. World Wide Web Consortium, @@, @@@@ @@@@. This version of the specification of the Web Services Policy 1.5 - Framework specification is ws-policy-framework.html. The latest version of Web Services Policy 1.5 - Framework<http://www.w3.org/TR/ws-policy-framework> is available at http://www.w3.org/TR/ws-policy-framework.



[Web Services Policy Attachment]

Web Services Policy 1.5 - Attachment<http://dev.w3.org/cvsweb/~checkout~/2006/ws/policy/ws-policy-attachment.html>, A. S. Vedamuthu, D. Orchard, M. Hondo, T. Boubez and P. Yendluri, Editors. World Wide Web Consortium, @@, @@@@ @@@@. This version of the specification of the Web Services Policy 1.5 - Attachment specification is ws-policy-attachment.html. The latest version of Web Services Policy 1.5 - Attachment<http://www.w3.org/TR/ws-policy-attachment> is available at http://www.w3.org/TR/ws-policy-attachment.



Please check that these references are correct.  The Framework is found at "http://www.w3.org/TR/ws-policy" and the Attachment is found at http://www.w3.org/TR/ws-policy-attach/. "framework" does not appear in the Framework URI and "attachment" does not occur in the Attachment URI.

2. Missing spaces

Section 3.1 - "Other child elements ofPolicy"

3. New comments

a) Table B-1. Prefixes and XML Namespaces used in this specification
There appear to be two duplicate rows in this table:


http://www.w3.org/@@@@/@@/ws-policy

[Web Services Policy Framework<http://dev.w3.org/cvsweb/~checkout~/2006/ws/policy/ws-policy-primer.html#WS-Policy#WS-Policy>, Web Services Policy Attachment<http://dev.w3.org/cvsweb/~checkout~/2006/ws/policy/ws-policy-primer.html#WS-PolicyAttachment#WS-PolicyAttachment>]

wsp

http://www.w3.org/@@@@/@@/ws-policy

[Web Services Policy Framework<http://dev.w3.org/cvsweb/~checkout~/2006/ws/policy/ws-policy-primer.html#WS-Policy#WS-Policy>, Web Services Policy Attachment<http://dev.w3.org/cvsweb/~checkout~/2006/ws/policy/ws-policy-primer.html#WS-PolicyAttachment#WS-PolicyAttachment>]


I think the blank prefix is supposed to imply that when there is no prefix that this implies the http://www.w3.org/@@@@/@@/ws-policy URI.  See the text earlier "XML elements without a namespace prefix are from the Web Services Policy XML Namespace ". I think this note should be repeated in this section to explain the empty prefix box.

Note as well that the left vertical border line and the top border line of the prefix box that is empty also appear to be different than all other border lines.

/paulc




Paul Cotton, Microsoft Canada
17 Eleanor Drive, Ottawa, Ontario K2E 6A3
Tel: (613) 225-5445 Fax: (425) 936-7329
mailto:Paul.Cotton@microsoft.com




________________________________
From: Prasad Yendluri [mailto:prasad.yendluri@webmethods.com]
Sent: September 28, 2006 4:07 PM
To: public-ws-policy-eds@w3.org; fsasaki@w3.org; Paul Cotton; Christopher B Ferris
Subject: Updated Primer for Editors and Chairs Sanity Check

Folks,

I have made the remaining changes that Paul raised in his mail (http://lists.w3.org/Archives/Public/public-ws-policy/2006Sep/0165.html)
The updated primer is available at:

http://dev.w3.org/cvsweb/~checkout~/2006/ws/policy/ws-policy-primer.html

I thought I would send it for the quick sanity check review of the editors and chairs this time around, prior to sending it to the WG.

1. I should note that the acknowledgements section is not fixed up yet.
The acknowledgements are all in a common file that is used by all (Framework, attachment and primer) documents, to create the Acknowledgements section.
It seems better done by the W3C staff. Both the membership and company affiliations need to be reflected accurately.

2. Once Acknowledgements are updated we need to regenerate the HTML version of the primer and Tag it in CVS so that we can give a hard pointer to the team.

Felix, could I request your help with the above two steps?

Thanks,
Prasad