Re: issue 7774 proposal

I'm sorry, but this sentence:

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.

is too tortured to make any sense. I know what you are trying to say, 
but that doesn't say it. How does this sound?

Unless otherwise specified by an extension, this operation will either 
replace the entire XML representation of the resource with the resource 
contained in the Put request message or, if the Put request message 
contains instructions, update the the XML representation based on those 
instructions.

- gp

On 1/22/2010 6:56 AM, Doug Davis wrote:
>
> Good catch.  Latest attached.
>
>
> 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/22/2010 09:53 AM
>
> 	
> To
> 	Doug Davis/Raleigh/IBM@IBMUS
> cc
> 	"public-ws-resource-access@w3.org" <public-ws-resource-access@w3.org>
> Subject
> 	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.
>