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
The more I'm around some people, the more I like my dog.



Ram Jeyaraman <Ram.Jeyaraman@microsoft.com> 
01/21/2010 05:23 PM

To
Doug Davis/Raleigh/IBM@IBMUS, "public-ws-resource-access@w3.org" 
<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] On Behalf Of Doug Davis
Sent: Wednesday, January 20, 2010 5:00 AM
To: 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
The more I'm around some people, the more I like my dog.