New Issue: 5189 Guidelines - BP 19 Lacks Motivation

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:34:40 UTC