8304 2009-11-14 03:43:51 +0000 Enum: misuse of RFC2119 terms 2010-03-17 10:51:31 +0000 1 1 1 Unclassified WS-Resource Access Enumeration FPWD All All CLOSED REMIND hasProposal P2 normal --- 1 gilbert.pilz gilbert.pilz dug public-ws-resource-access-notifications oldest_to_newest 29577 0 gilbert.pilz 2009-11-14 03:43:51 +0000 The RFC 2119 terms "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" are meant to apply to specific requirements and behaviors within the context of a specification. They are *not* meant to refer to general concepts and actions. To quote RFC 2119: "Imperatives of the type defined in this memo must be used with care and sparingly. In particular, they MUST only be used where it is actually required for interoperation or to limit behavior which has potential for causing harm (e.g., limiting retransmisssions)" WS-Enumeration contains a number of cases where RFC 2119 keywords are misused. A changebar copy of WS-Enumeration will be sent to the mailing list and linked in the comments below. 31625 1 bob 2010-02-08 01:04:26 +0000 proposal at http://lists.w3.org/Archives/Public/public-ws-resource-access/2010Feb/0005.html 31682 2 bob 2010-02-09 21:07:41 +0000 partial change to proposal in comment 1 to The ordering or completeness of the enumeration is undefined; the returned data items represent a selection by the data source of items it wishes to present to that consumer at that time in that order, with no guarantee that every available item is returned or that the order in which items is returned has any semantic meaning whatsoever (of course, any specific data source can provide strong guarantees, if so desired). 31683 3 bob 2010-02-09 21:18:18 +0000 partial change additional to above to proposal in comment 1 The consumer MUST NOT issue additional Pull request messages after a Pull response containing a wsen:EndOfSequence element has been received. 31684 4 bob 2010-02-09 21:22:59 +0000 Additional modifications to the proposal in comment #1 Upon successful processing of a Pull request message, a data source MUST return a Pull response message of the following form: Upon successful processing of a Release request message, a data source MUST return a Release response message of the following form: 31685 5 bob 2010-02-09 21:26:02 +0000 additional change to the proposal in section 3 in the proposal contained in comment #1 Upon successful processing of an Enumerate request message, a data source MUST create an enumeration context and return that context in an Enumerate response message of the following form: 31686 6 bob 2010-02-09 21:27:06 +0000 resolved with comments 1-5