Re: [sca-bindings] WS Binding CD02 rev1

[Simon Nash <oasis@cjnash.com>]

Anish,
Thanks for your work on this.  Here are my comments.

Major issue:

  All cross-references for conformance statements and tags are wrong.

  The bookmark R_BWSxxxxx should be the [BWSxxxxx] tag in the main
  chapter text, with a cross-reference in the "Conformance ID" column
  of Appendix B.  Instead this bookmark is the main chapter text
  describing BWSxxxxx, with a cross-reference in the "Description"
  column of Appendix B.

  The bookmark BWSxxxxx should be the text describing BWSxxxxx in the
  "Description" column of Appendix B, with a cross-reference preceding the
  [BWSxxxxx] tag in the main chapter text.  Instead this bookmark is the
  [BWSxxxxx] tag in the "Conformance ID" column of Appendix B, with a
  cross-reference following the main chapter text describing BWSxxxxx.

Editorial comments:

  1. In front matter "Related Work", change "supercedes" to "supersedes".

  2. In front matter "Abstract", fix typo "of an SCA composites".

  3. In front matter "Notices" last paragraph, fix typo "names OASIS is".

  4. In section 1.1, change [[RCF2119]] to [RFC2119].

  5. In section 1.4, use Word cross-reference for [SCA-Assembly].

  6. In section 2 bulleted list, there are 3 cross-references to
     [SCA-Assembly] under /binding.ws/wsdlElement which should be
     Word cross-references.

  7. In section 2 bulleted list, /binding.ws/wireFormat and
     /binding.ws/operationSelector should be in bold italic font.

  8. In section 2 bulleted list, cross-references to [SCA-Assembly]
     in /binding.ws/wireFormat and /binding.ws/operationSelector
     should be Word cross-references.

  9. In section 2.3, the Word cross-reference to [SCA-JCAA] points
     to [SCA-Policy].

10. In section 4.1, the cross-reference (R2705) should use square
     brackets instead of parentheses.  Also, it should point to a
     reference in section 1.2 instead of directly to a section of
     http://www.ws-i.org/Profiles/BasicProfile-1.2.html (which is
     not one of the documents listed in section 1.2).

11. In section 4.2.1, conformance statement [BWS40004], fix
     typo "from the that interface".

12. In section 4.2.2, delete the colon after [BWS40005].

13. In section 4.2.2, the paragraphs containing conformance statments
     [BWS40006] and [BWS40007] should not be indented.

14. In section 4.2.2, conformance statement [BWS40007], fix
     typo "structureal".

15. In section 5.1 first paragraph, add a Word cross-reference for
     [SCA-Assembly].

16. In section 5.1 second paragraph, change [SCA-ASSEMBLY] to
     [SCA-Assembly} and add a Word cross-reference.

17. In section 5.2, change Appendix XXX to Appendix B.

18. In section 5.2, add Word cross-references for [SCA-Assembly] and
     [SCA-Policy].

19. In conformance statement BWS20005, fix double blank in
     "runtime MUST".

20. In conformance statement BWS20019, fix wrong font (Verdana
     instead of Arial) and spurious indentation in opening paragraph
     and first two bullets.

21. In conformance statement BWS20019, third bulleted item does
     not have a bullet and is wrongly indented.

22. In conformance statements BWS20021/22/23/24, fix wrong font
     (Verdana instead of Arial).

23. In conformance statement BWS20032, fix wrong font (Verdana
     instead of Arial) and spurious indentation.

24. In Appendix D, add the list of contributors.

   Simon

Anish Karmarkar wrote:
> Available at:
> http://www.oasis-open.org/committees/download.php/32787/sca-binding-ws-1.1-spec-cd02-rev1.doc 
> 
> http://www.oasis-open.org/committees/download.php/32788/sca-binding-ws-1.1-spec-cd02-rev1.pdf 
> 
> 
> I used SimonH's issue 61 rev3 document as the starting point. CD02 rev1 
> includes resolutions of all the resolved issues + all the action items 
> against the ws binding editors. Appendix F contains the revision history.
> 
> The front page/footer isn't quite right (links, date, title etc) wrt 
> what we need for CD03/PRD and will be changed before publication.
> 
> I have also attached the diff version (PDF).
> 
> -Anish
> -- 
> 
> 
> ------------------------------------------------------------------------
> 
> ---------------------------------------------------------------------
> To unsubscribe from this mail list, you must leave the OASIS TC that
> generates this mail.  Follow this link to all your TCs in OASIS at:
> https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php