[Bug 3979] [Guidelines] Clarify guidance in section 5.9.1 on referencing policy expressions

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

           Summary: [Guidelines] Clarify guidance in section 5.9.1 on
                    referencing policy expressions
           Product: WS-Policy
           Version: PR
          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] Clarify the guidance in section 5.9.1 on referencing policy
expressions

Description: Section 5.9.1 in the Guidelines document currently recommends that
policy assertion authors “consider specifying or recommending naming
conventions in order to promote reuse” through policy referencing [1].  It is
not clear how using naming conventions for policies promotes reuse.  No
examples of useful naming conventions are given.  This section appears
unnecessary.

Justification: Section 5.9.1 provides unclear guidance that could result in
confusion.

Target: Guidelines for Assertion Authors

Proposal: Remove section 5.9.1 or clarify the text.

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

Received on Saturday, 18 November 2006 01:15:02 UTC