[Bug 8183] New: Transfer: be clear on fault for bad representation

http://www.w3.org/Bugs/Public/show_bug.cgi?id=8183

           Summary: Transfer: be clear on fault for bad representation
           Product: WS-Resource Access
           Version: FPWD
          Platform: PC
        OS/Version: Windows XP
            Status: NEW
          Severity: normal
          Priority: P2
         Component: Transfer
        AssignedTo: public-ws-resource-access-notifications@w3.org
        ReportedBy: dug@us.ibm.com
         QAContact: public-ws-resource-access-notifications@w3.org


Transfer.Put() says:
--
Implementations MAY use the fault code wst:InvalidRepresentation if the
presented representation is invalid for the target resource. The replacement
representation could be considered to be invalid if it does not conform to the
schema(s) for the target resource or otherwise violates some cardinality or
type constraint. If an implementation detects that the presented representation
is invalid it MUST generate a wst:InvalidRepresentation fault. 
--

The MAY in the first sentence is inconsistent with the MUST at the end.

Also, Create says:
--
In addition to the standard fault codes defined in WS-Addressing,
implementations MAY use the fault code wst:InvalidRepresentation if the
presented representation is invalid for the target resource. 
--
Why mention WSA faults?  that's just odd.
Why MAY?  For consistency, and interop, we should make this a MUST.

Proposal:
Replace first para with:
Implementations MUST use the fault code wst:InvalidRepresentation if the
presented representation is invalid for the target resource. The replacement
representation could be considered to be invalid if it does not conform to the
schema(s) for the target resource or otherwise violates some cardinality or
type constraint.
(s/MAY/MUST/ and remove last sentence)

And in Create replace that sentence with:
An implementation MUST use the fault code wst:InvalidRepresentation if the
presented representation is invalid for the target resource.


-- 
Configure bugmail: http://www.w3.org/Bugs/Public/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the QA contact for the bug.
You are the assignee for the bug.

Received on Wednesday, 4 November 2009 18:35:47 UTC