[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: Re: [sca-bindings] WS Binding CD02 rev1
Fixed in cd02-rev3. -Anish -- Simon Nash wrote: > I found a couple of glitches while checking the cross-references: > > 3. In section 2, the cross-reference to SCA-Assembly in the bullet for > /binding.ws/@policySets isn't correctly formatted. > > 4. In section 2, the cross-reference [SCA-Assembly] in the bullet for > /binding.ws/operationSelector should have a blank before it. > > Simon > > Simon Nash wrote: >> Anish, >> Here are my comments on the latest draft. >> >> 1. The colon following [BWS40005] in section 4.2.2 is not correct and >> should be changed to a period. Also, [BWS40006] and [BRS40007] >> should not be a bulleted list. >> >> The default transport binding rules are defined in the previous >> bulleted list at the start of section 4.2.2. This non-normative >> definition is followed by three normative statements BWS40005, >> BWS40006 and BWS40007 that refer back to the previous definition. >> These three normative statements are independent of each other and >> should not be linked together, either by a colon or by bulleted >> indentation. >> >> 2. The text for BWS20018 refers to the "semantics of this >> attribute". When reading the standalone conformance statement in >> Appendix B, it isn't clear which attribute is intended. This text >> should read "semantics of the @wsdli:wsdlLocation attribute". >> >> Simon >> >> Anish Karmarkar wrote: >>> Created CD02-rev2 by making the ed changes pointed out by SimonN as >>> well as reversed the way the 2119 keyword stmt bookmarks/crossrefs >>> worked to match that of assembly (was a major PITA to change it). I >>> also did some formating/ed changes and fixed a few refs/crossrefs. >>> More detailed comments inlined below. >>> >>> CD02-rev2 (Word & PDF): >>> http://www.oasis-open.org/apps/org/workgroup/sca-bindings/download.php/32884/sca-binding-ws-1.1-spec-cd02-rev2.doc >>> >>> http://www.oasis-open.org/apps/org/workgroup/sca-bindings/download.php/32885/sca-binding-ws-1.1-spec-cd02-rev2.pdf >>> >>> >>> Diff between CD02-rev1 and CD02-rev2: >>> http://www.oasis-open.org/apps/org/workgroup/sca-bindings/download.php/32886/sca-binding-ws-1.1-spec-cd02-rev1-rev2-diff.pdf >>> >>> >>> Diff between CD02 and CD02-rev2: >>> http://www.oasis-open.org/apps/org/workgroup/sca-bindings/download.php/32887/sca-binding-ws-1.1-spec-cd02-rev2-diff.pdf >>> >>> >>> -Anish >>> -- >>> >>> Simon Nash wrote: >>>> 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". >>>> >>> >>> Done. >>> >>>> 2. In front matter "Abstract", fix typo "of an SCA composites". >>>> >>> >>> Done. >>> >>>> 3. In front matter "Notices" last paragraph, fix typo "names OASIS >>>> is". >>>> >>> >>> Done. >>> >>>> 4. In section 1.1, change [[RCF2119]] to [RFC2119]. >>>> >>> >>> Done. >>> >>>> 5. In section 1.4, use Word cross-reference for [SCA-Assembly]. >>>> >>> >>> Done. >>> >>>> 6. In section 2 bulleted list, there are 3 cross-references to >>>> [SCA-Assembly] under /binding.ws/wsdlElement which should be >>>> Word cross-references. >>>> >>> >>> Done. >>> >>>> 7. In section 2 bulleted list, /binding.ws/wireFormat and >>>> /binding.ws/operationSelector should be in bold italic font. >>>> >>> >>> Done. >>> >>>> 8. In section 2 bulleted list, cross-references to [SCA-Assembly] >>>> in /binding.ws/wireFormat and /binding.ws/operationSelector >>>> should be Word cross-references. >>>> >>> >>> Done. >>> >>>> 9. In section 2.3, the Word cross-reference to [SCA-JCAA] points >>>> to [SCA-Policy]. >>>> >>> >>> Done. >>> >>>> 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). >>>> >>> >>> Fixed to point to the reference in section 1.2. >>> >>> >>>> 11. In section 4.2.1, conformance statement [BWS40004], fix >>>> typo "from the that interface". >>>> >>> >>> Done. >>> >>>> 12. In section 4.2.2, delete the colon after [BWS40005]. >>>> >>> >>> Colon is necessary (per the issue resolution). >>> >>>> 13. In section 4.2.2, the paragraphs containing conformance statments >>>> [BWS40006] and [BWS40007] should not be indented. >>>> >>> >>> They have to be indented. It is supposed to be a list. Fixed. >>> >>>> 14. In section 4.2.2, conformance statement [BWS40007], fix >>>> typo "structureal". >>>> >>> >>> Done. >>> >>>> 15. In section 5.1 first paragraph, add a Word cross-reference for >>>> [SCA-Assembly]. >>>> >>> >>> Done. >>> >>>> 16. In section 5.1 second paragraph, change [SCA-ASSEMBLY] to >>>> [SCA-Assembly} and add a Word cross-reference. >>>> >>> >>> Done. >>> >>>> 17. In section 5.2, change Appendix XXX to Appendix B. >>>> >>> >>> Done. >>> >>>> 18. In section 5.2, add Word cross-references for [SCA-Assembly] and >>>> [SCA-Policy]. >>>> >>> >>> Done. >>> >>>> 19. In conformance statement BWS20005, fix double blank in >>>> "runtime MUST". >>>> >>> >>> Done. >>> >>>> 20. In conformance statement BWS20019, fix wrong font (Verdana >>>> instead of Arial) and spurious indentation in opening paragraph >>>> and first two bullets. >>>> >>> >>> Not sure why this was showing up. >>> Encountered some strange word bug (or lack of word skills). BWS20019 >>> now does not have any bullets. >>> >>>> 21. In conformance statement BWS20019, third bulleted item does >>>> not have a bullet and is wrongly indented. >>>> >>> >>> See above. >>> >>>> 22. In conformance statements BWS20021/22/23/24, fix wrong font >>>> (Verdana instead of Arial). >>>> >>> >>> Fixed. >>> >>>> 23. In conformance statement BWS20032, fix wrong font (Verdana >>>> instead of Arial) and spurious indentation. >>>> >>> >>> Fixed. >>> >>>> 24. In Appendix D, add the list of contributors. >>>> >>> >>> SimonH: can you provide me a list. This needs to go in all the >>> binding specs. >>> >>>> 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 >>>> >>>> >>> >>> >> >> >> >> --------------------------------------------------------------------- >> 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 >> >> > > > > --------------------------------------------------------------------- > 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
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]