Proposed Resolution: Primer Issue 3791 (was FW: [Bug 3791] primer/guidelines overlap

First, issues 3791 and 3792 are tightly related. Agree that the
guidelines should be in one document. The attached document is our
proposed resolution for issue 3791.

Description

a) Three bullets in Section 1 (Primer) identify three different target
audiences for the Primer. No changes are necessary to these three
bullets.

b) Section 3 provides more in-depth material (on policy) for policy
implementers and assertion authors. Section 3 does not outline any
guidelines for assertion authors. No changes are necessary to the fifth
paragraph.

c) Section 4 overlaps with the Guidelines document. We suggest replacing
the sixth paragraph with some text pointing to the Guidelines document.

Regards,
 
Asir S Vedamuthu
Microsoft Corporation

-----Original Message-----
From: public-ws-policy-qa-request@w3.org
[mailto:public-ws-policy-qa-request@w3.org] On Behalf Of
bugzilla@wiggum.w3.org
Sent: Wednesday, October 04, 2006 7:30 AM
To: public-ws-policy-qa@w3.org
Subject: [Bug 3791] primer/guidelines overlap


http://www.w3.org/Bugs/Public/show_bug.cgi?id=3791





------- Comment #1 from chrisfer@us.ibm.com  2006-10-04 14:30 -------
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