[Bug 5189] Guidelines - BP 19 Lacks Motivation

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

           Summary: Guidelines - BP 19 Lacks Motivation
           Product: WS-Policy
           Version: LC
          Platform: PC
        OS/Version: Windows NT
            Status: NEW
          Severity: normal
          Priority: P2
         Component: Guidelines
        AssignedTo: fsasaki@w3.org
        ReportedBy: asirveda@microsoft.com
         QAContact: public-ws-policy-qa@w3.org


Title: Guidelines - BP 19 Lacks Motivation

Description:

"Best Practice 19: Consider entire message exchange pattern when specifying
Assertions that may be optional

Assertion Authors should associate optional assertions with the appropriate
endpoint and use the smallest possible granularity to limit the degree to which
optionality applies." [1]

The best practice that applies to granularity is covered by best practice 28
[2]. It is unclear why an assertion author would associate an assertion with
"the appropriate endpoint". It is also unclear what behavior that the best
practice is trying to motivate.

Justification: unclear best practice.

Target: Guidelines.

Proposal: This is a two part proposal -

a) Drop best practice 19.
b) s/This is important for an optional assertion where it may not be clear
whether it is to apply in a message exchange when optionally used in part of
that exchange (Best Practice: Consider entire message exchange pattern when
specifying Assertions that may be optional).//

[1]
http://www.w3.org/TR/2007/WD-ws-policy-guidelines-20070928/#bp-entire-mep-for-optional
[2]
http://www.w3.org/TR/2007/WD-ws-policy-guidelines-20070928/#bp-WSDL-policy-subject-Granularity

Regards,

Asir S Vedamuthu
Microsoft Corporation

Received on Saturday, 13 October 2007 02:30:52 UTC