RE: Guidelines Doc Review - By Prasad and Asir

Fixed a5) and a6).

Added editors' note in Section 5.8 - To be re-structured to use the format in the Architecture of the WWW doc.

Added editors' note in Section 5.5 - Looks incomplete - carries Good Practices but there isn't any explanatory text.

Added editors' note in Section 5.1 - May 9th 07, an issue was opened against G2 - issue 4566.

Regards,

Asir S Vedamuthu
Microsoft Corporation

From: public-ws-policy-eds-request@w3.org [mailto:public-ws-policy-eds-request@w3.org] On Behalf Of Asir Vedamuthu
Sent: Friday, May 18, 2007 4:40 PM
To: public-ws-policy-eds@w3.org
Cc: Prasad Yendluri
Subject: Guidelines Doc Review - By Prasad and Asir

Prasad and I reviewed the Guidelines document and discovered a few items.


a)  The following Good Practices from the IBM and MS contribution are missing in the Guidelines document:

1)  G1 - An assertion author should reuse an existing assertion (rather than create a new one) whenever possible.
Designated home: 5.3.4

2)  G2 - An assertion author should define policy assertions for behaviors that are relevant to compatibility tests, such as web service protocols that manifest on the wire.
Open issue: 4556

3)  G3 - An assertion author should use a unique QName to identify a distinct behavior.
Designated home: 5.3.2

4)  G20 - An assertion author should start with a simple working assertion that allows assertion parameter extensibility.
Designated home: 5.3.1

5)  G21 - An assertion description should clearly specify how the assertion may compose with other related assertions, if any.
Designated home: 5.8

6)  G22 - An assertion author should not define policy assertions to represent information that is necessary to understand a message.
Designated home: 5.3.3

b)  Section 5.5 looks incomplete - carries Good Practices but there isn't any explanatory text.

Prasad is fixing items a1), a3) and a4). Asir is fixing items a5) and a6).

Regards,

Asir S Vedamuthu
Microsoft Corporation