W3C home > Mailing lists > Public > public-ws-policy@w3.org > October 2006

new Issues- primer/guidelines overlap

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 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Tuesday, 8 January 2008 14:20:42 GMT