RE: issue 7774 proposal

The concrete proposal looks good.

One editorial nit: (remove an 'and')

Change:


Ø  Unless otherwise specified by an extension, this operation will replace the entire XML representation of the resource based on the representation, or updated based on the instructions, provided in the Put request message. When this operation is used to replace the entire XML representation, and any OPTIONAL values (elements or attributes) not specified in the Put request message will be set to a resource-specific default value.

To:


Ø  Unless otherwise specified by an extension, this operation will replace the entire XML representation of the resource based on the representation, or updated based on the instructions, provided in the Put request message. When this operation is used to replace the entire XML representation, any OPTIONAL values (elements or attributes) not specified in the Put request message will be set to a resource-specific default value.

Thanks.

From: Doug Davis [mailto:dug@us.ibm.com]
Sent: Friday, January 22, 2010 5:11 AM
To: Ram Jeyaraman
Cc: public-ws-resource-access@w3.org
Subject: RE: issue 7774 proposal


I'm ok with the general direction of the modifications - it got a bit wordy for me in one spot though.
I've attached a concrete proposal with the latest version.


thanks
-Doug
______________________________________________________
STSM |  Standards Architect  |  IBM Software Group
(919) 254-6905  |  IBM 444-6905  |  dug@us.ibm.com<mailto:dug@us.ibm.com>
The more I'm around some people, the more I like my dog.

Ram Jeyaraman <Ram.Jeyaraman@microsoft.com<mailto:Ram.Jeyaraman@microsoft.com>>

01/21/2010 05:23 PM

To

Doug Davis/Raleigh/IBM@IBMUS, "public-ws-resource-access@w3.org<mailto:public-ws-resource-access@w3.org>" <public-ws-resource-access@w3.org<mailto:public-ws-resource-access@w3.org>>

cc

Subject

RE: issue 7774 proposal







Proposed changes 1 and 2 seem fine.

On proposed change 3:


>  3) follow Create's lead by adding this to the end of the [Body]/wst:Put description:
    The first child element, if present, MUST be the literal resource representation or other instructions for updating the resource.

I suggest the following change.

Change:

[Body]/wst:Put
This REQUIRED element MUST have as its first child element, an element that comprises the representation of the resource that is to be replaced.
To:
[Body]/wst:Put
This REQUIRED element MUST have as its first child element, an element that comprises the representation of the resource that is to be replaced or instructions for updating the resource.
Further, I suggest the following change:

Change:

>  Unless otherwise specified by an extension, this operation will replace the entire XML representation of the resource, and any OPTIONAL values (elements or attributes) not specified in the Put request message will be set to a resource-specific default value.

To:

>  Unless otherwise specified by an extension, this operation will replace the entire XML representation of the resource based on the representation provided in the Put request message or update the resource based on the instructions provided in the Put request message. When this operation is used to replace the entire XML representation, any OPTIONAL values (elements or attributes) not specified in the Put request message will be set to a resource-specific default value.

Thanks.


From: public-ws-resource-access-request@w3.org<mailto:public-ws-resource-access-request@w3.org> [mailto:public-ws-resource-access-request@w3.org]<mailto:[mailto:public-ws-resource-access-request@w3.org]> On Behalf Of Doug Davis
Sent: Wednesday, January 20, 2010 5:00 AM
To: public-ws-resource-access@w3.org<mailto:public-ws-resource-access@w3.org>
Subject: issue 7774 proposal


Yves and I chatted a bit and here's the proposal we came up with to solve 7774 [1]:

1) changed transfer's put from:
    This specification defines one Web service operation (Put) for updating a resource by providing a replacement representation.
to:
    This specification defines one Web service operation (Put) for updating a resource.

2) change transfer's put from:
   A Put request MUST be targeted at the resource whose representation is desired to be replaced,
to:
   A Put request MUST be targeted at the resource whose representation is desired to be replaced or updated,

3) follow Create's lead by adding this to the end of the [Body]/wst:Put description:
    The first child element, if present, MUST be the literal resource representation or other instructions for updating the resource.

The basic idea is to make it clear, in transfer, that Put supports the notion of an instruction and not just a complete representation replacement.

[1] http://www.w3.org/Bugs/Public/show_bug.cgi?id=7774

thanks
-Doug
______________________________________________________
STSM |  Standards Architect  |  IBM Software Group
(919) 254-6905  |  IBM 444-6905  |  dug@us.ibm.com<mailto:dug@us.ibm.com>
The more I'm around some people, the more I like my dog.