W3C home > Mailing lists > Public > public-ws-policy-eds@w3.org > May 2007

RE: Guidelines Doc Review - By Prasad and Asir

From: Asir Vedamuthu <asirveda@microsoft.com>
Date: Sun, 20 May 2007 11:05:07 -0700
To: "public-ws-policy-eds@w3.org" <public-ws-policy-eds@w3.org>
CC: Prasad Yendluri <prasad.yendluri@webmethods.com>
Message-ID: <C9BF0238EED3634BA1866AEF14C7A9E543152A5590@NA-EXMSG-C116.redmond.corp.microsoft.com>
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
Received on Sunday, 20 May 2007 18:05:22 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Tuesday, 8 January 2008 14:21:03 GMT