- From: Maryann Hondo <mhondo@us.ibm.com>
- Date: Wed, 4 Oct 2006 11:10:33 -0400
- To: <public-ws-policy@w3.org>
- Message-ID: <OFC06B0CAC.8E6EEBFB-ON872571FD.005231D7-852571FD.00534EE4@us.ibm.com>
I have opened several bugs to try to identify overlaps between the two documents the WG has agreed to author. 3791, 3792, 3794, 3795 [summary and links below] Maryann ----------------------------- http://www.w3.org/Bugs/Public/show_bug.cgi?id=3791 Title: primer/guidelines overlap Description: intro to the primer---- states that three are 3 target audiences..... the target audience should ONLY bullet 2 ("for policy implementors whose software modules read and write policy expressions") explanation of sections 3 & 4 "Advanced concepts" overlap with guidance to assertion authors Justification: The guidelines should be in one document to ensure that the guidance is consistent. Target: Primer Proposal: TBD http://www.w3.org/Bugs/Public/show_bug.cgi?id=3792 Title: section 4 of the primer overlaps with the guidelines document Description: This adivce is targetted to authors of assertions and should be covered by the guidelines document Justification: The guidelines should be in one document to ensure that the guidance is consistent. Target: Primer Proposal: TBD http://www.w3.org/Bugs/Public/show_bug.cgi?id=3794 Title: Section 3 of primer overlaps with guidelines Description: Section 3 ["In 2. Basic Concepts: Policy Expression, we covered the basics of Web Services Policy language. This is the first advanced section that provides more in-depth materials for Web Services Policy implementers and assertion authors."] Justification: The guidelines should be in one document to ensure that the guidance is consistent. Target: Primer Proposal: remove references to providing guidance to policy assertion authors and point to the guidelines document http://www.w3.org/Bugs/Public/show_bug.cgi?id=3795 Title: Section 2.4- Usefulness Description: Section 2.4- I'm not sure of the usefulness of the section in the primer. It seems to be a non-exhaustive list and would be difficult to maintain. Specifically is it appropriate for the primer to reference company specific implementaitons and documents? i.e., "A Technical Reference for Windows CardSpace"? Is this a catalog of all uses? If so, do we need to include other uses and how do we collect this? Justification : Target: Primer Proposal: TBD
Received on Wednesday, 4 October 2006 15:10:56 UTC