Re: issue 7774 proposal

ok - I tweaked it by adding "represenation" after "...with the resource" 
though.  new version 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.



Gilbert Pilz <gilbert.pilz@oracle.com> 
01/22/2010 05:33 PM

To
Doug Davis/Raleigh/IBM@IBMUS
cc
Ram Jeyaraman <Ram.Jeyaraman@microsoft.com>, 
"public-ws-resource-access@w3.org" <public-ws-resource-access@w3.org>
Subject
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
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. 

Received on Saturday, 23 January 2010 03:07:20 UTC