This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.

Bug 8302 - Transfer: descriptions of PutResponse and CreateResponse contain unclear sections
Summary: Transfer: descriptions of PutResponse and CreateResponse contain unclear sect...
Status: CLOSED REMIND
Alias: None
Product: WS-Resource Access
Classification: Unclassified
Component: Transfer (show other bugs)
Version: FPWD
Hardware: All All
: P2 normal
Target Milestone: ---
Assignee: Gilbert Pilz
QA Contact: notifications mailing list for WS Resource Access
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2009-11-14 03:30 UTC by Gilbert Pilz
Modified: 2010-03-17 11:27 UTC (History)
1 user (show)

See Also:


Attachments

Description Gilbert Pilz 2009-11-14 03:30:18 UTC
The description of PutResponse contains the following paragraph:

"Such a response (an empty wst:PutResponse) implies that the update request was successful in its entirety (assuming no intervening mutating operations are performed). A service MAY return the current representation of the resource as the child of the wst:PutResponse element even in this case, however."

The description of CreateResponse contains the following paragraph:

"As an optimization and as a service to the requestor, the wst:CreateResponse element of the response message SHOULD be empty, other than the ResourceCreated element, if the created representation does not logically differ from the representation sent in the Create request message and there are no extension elements; that is, if the service accepted the new representation or creation instructions verbatim. Such a response indicates that the request was completely successful (assuming no intervening mutating operations are performed). A service MAY return the current representation of the resource as the second child of the wst:CreateResponse element even in this case, however."

You can sort of get the gist of what both of these paragraphs are trying to say but it's not completely clear.

General Proposal: reword for clarity
Comment 3 Robert Freund 2010-01-26 19:53:15 UTC
Remove the sentence "This second child element, if present, MAY be an empty element depending on the resource representation." from the above proposal from CreateResponse. in the above proposal
Comment 6 Robert Freund 2010-01-28 18:31:24 UTC
Amendments:
in five places in the proposed change replace "representation" with "full representation"

A parallel change in the frag spec in the pseudo schema of put response is required.

Comment 7 Doug Davis 2010-01-29 03:22:49 UTC
This is the correct link to the proposal:
http://lists.w3.org/Archives/Public/public-ws-resource-access/2010Jan/0190.html