[Bug 3985] [Guidelines] Section 5.3.1 should use the definition of policy assertion parameters from the Framework spec

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

           Summary: [Guidelines] Section 5.3.1 should use the definition of
                    policy assertion parameters from the Framework spec
           Product: WS-Policy
           Version: FPWD
          Platform: PC
        OS/Version: Windows XP
            Status: NEW
          Severity: normal
          Priority: P2
         Component: Guidelines
        AssignedTo: fsasaki@w3.org
        ReportedBy: Daniel.Roth@microsoft.com
         QAContact: public-ws-policy-qa@w3.org
                CC: Daniel.Roth@microsoft.com


Title: [Guidelines] Section 5.3.1 should use the definition of policy assertion
parameters from the Framework spec

Description: Section 5.3.1 in the Guidelines document currently states [1]:

Note that parameters of assertions include the following:

·         Complex elements with element children that cannot be policy
assertions. 
·         Elements that have attributes 

This definition is not accurate.  The Framework spec states in section 3.1 [2]:

"The XML Infoset of a policy assertion MAY contain a non-empty [attributes]
property and/or a non-empty [children] property. Such properties are policy
assertion parameters and MAY be used to parameterize the behavior indicated by
the assertion."

Rather than redefine policy assertion parameters, the Guidelines doc should use
and reference the definition in the Framework spec.

Justification: The current text in the Guidelines doc is inconsistent with text
in the Framework spec.

Target: Guidelines for Policy Assertion Authors

Proposal: Change the third paragraph in section 5.3.1 in the Guidelines doc as
shown in the attachment.

[1]
http://dev.w3.org/cvsweb/~checkout~/2006/ws/policy/ws-policy-guidelines.html?rev=1.8&content-type=text/html;%20charset=utf-8#parameterized-assertions

[2]
http://dev.w3.org/cvsweb/~checkout~/2006/ws/policy/ws-policy-framework.html?content-type=text/html;%20charset=utf-8#rPolicy_Assertion

Received on Saturday, 18 November 2006 01:24:35 UTC