RE: [wsn] sgg comments on BrokeredN

["David A. Chappell" <chappell@sonicsoftware.com>]

See below -

---

From: Steve Graham [mailto:sggraham@us.ibm.com]
Sent: Monday, June 07, 2004 10:18 AM
To: wsn@lists.oasis-open.org
Subject: [wsn] sgg comments on BrokeredN

Hi Guys:
A few comments (as markup on the document).  

Here are the highlights of my quick review:

1. There didn't seem to be much markup in the text itself.  Can the editors comment on what text has changed?  

[dc - revision tracking is enabled in the latest version] 

2. (nit) the file name doesn't seem  to reflect the file naming convention (URL, however looks ok)  

[dc - fixed] 

3. We need to (as a TC) think about changing the date to 2004/06 (William has suggested this, and I concur)  

[dc - fixed] 

4. I recommend that we move the contributors list to an appendix (keeps the forematter shorter)  

[dc - done] 

5. For BaseN, we included a goals and requirements section, essentially text copied/pasted from the PubSub whitepaper, perhaps we should do it here as well? (in BaseN, this appears as section 1.1)  

[dc - todo] 

6. The namespace prefixes in section 1.2 should refer to the .xsd (for the most part) and include namespace prefixes for the WSDL.  

[dc - done...need to add more wsdl references still] 

7. Instead of using tabs in the various XML listings, please use 3 spaces  

[dc - todo] 

8. The examples (eg section 5.4.1, and other sections) should use the timestamped URI to the xsd for BrokeredN as the URI to associate with the prefix wsbn  

[dc - done] 

9. The examples (eg section 5.4.1 and other sections) should use the element name "NPResourceDisambiguator" instead of "NPResourceId"  

[dc - done] 

10. Section 8, add the URLs to the references.  The hyperlink is cool, but not useful for folks who print the document out. There are those who don't read this kind of thing electronically, and I am not naming names :-)  

[dc - done, but need to revisit some of the references to use the public links to pdfs] 

11. Make Appendix A more compact by using comma separated list of names  

[dc - done.  William should also fix WS-Topics] 

12. Change the (c) on the XML and WSDL in the appendicies  

[dc - done] 

13. Appendix E and F seemed to have an unusual number of spaces in the footer  

[dc - I think you were referring to the extra newlines between the /endtags? - done] 

14. Can you verify that the XML and WSDL validate?

 [dc - todo]

 

Dave

 
sgg
++++++++
Steve Graham
(919)254-0615 (T/L 444)
STSM, On Demand Architecture
Member, IBM Academy of Technology
<Soli Deo Gloria/>
++++++++