Issue 6413 - Merge WST/T : Proposal

Doug and I propose the following to resolve issue 
http://www.w3.org/Bugs/Public/show_bug.cgi?id=6413.
Thanks
Katy

GENERAL COMMENTS (Applying to the complete document)
----------------------------------------------------

- This proposal takes the WS-Transfer specification as a base for the 
merge of the two specs (i.e. copy WS-RT into WS-T with minimum change to 
existing WS-T text).

- Replace all existences of wsrt namespace/prefix with wst 
namespace/prefix.

- Stylistic differences - bring wsrt in line with wst.
For example:
[Body]/wsrt:Get/wsrt:Expression 
becomes
/s:Envelope/s:Body/wst:Get/wst:Expression


Resource/Factory operation Sections
-----------------------------------

- The key aspect of this proposal is the merging of the Resource/Factory 
operations.  The pattern for merging these operations is likely to be the 
same so we've started by taking "Get" as an example.  Details for the 
other operations will follow.

Proposal for "Get" operation: 




Introduction and Terminology and Notation Sections
--------------------------------------------------

- Introduction 
After the following text in WST introduction:
"Specifically, it defines two operations for sending and receiving the
representation of a given resource and two operations for creating and
deleting a resource and its corresponding representation."
Add the following (this is taken from WSRT with modification):
"This specification also defines optional extensions in order to deal with 
fragment-based access to resources."

- Add WSRT requirements to those listed in WST that are generic and not 
management specific 

- Add WSRT non-requirements section to WST

- WSRT Example
The example in the introductory section is useful but would detract from 
the core usage scenario of WS-T if it was copied to the WS-T introduction. 
 
Proposal: Move this example to an appendix in WS-T entitled "Example 
Resource Fragment Get".  Raise an issue to integrate examples into the 
main text when it merge is stablised.

- Terminology: Resource
Text for the 2 specs differs and requires reconciliation.  Here are the 
current texts for discussion in WG.
WST:
A Web service that is addressable by an endpoint reference as defined
in WS-Addressing and that can be represented by an XML Infoset using
the Get and Put operations defined in this specification.
WSRT:
A Web service that is addressable by an endpoint reference as defined in 
WS-Addressing and that can be represented by an XML document. This 
representation can be accessed using the operations defined in the 
WS-Transfer and WS-ResourceTransfer specifications.
Proposal: use the text in wst 

- Terminology: WSRT Resource representation, Metadata resource, fragment, 
epr
Add these definitions to wst spec.

- XML Namespaces:
Add ws-mex namespace to list in WST.

- Compliance
Proposal - leave compliance section as is.  Ensure wsrt aspects of spec 
are clearly defined as optional in the main text.

Section 4 "Extensions to WS-Transfer" section in WS-RT
------------------------------------------------------

- Add a new section prior to section 3 "Resource Operations" in 
WS-Transfer called "Support for Resource Fragments".  Move the text from 
Section 4 "Extensions to WS-Transfer" section in WS-RT to this new section 
subject to global namespace/prefix/name changes agreed as a result of the 
rest of the proposal.

- Replace the first sentence of this section:
"WS-Transfer defines operations to Get, Put, Create and Delete 
representations of resources. WS-ResourceTransfer extends these operations 
to add the capability to operate on fragments of the resource 
representations. "
with the following:
"Implementations of WS-Transfer may optionally support fragment-based 
access to resources.  This section describes the key aspects of such 
support."

Faults
------

Proposal:

- Remove WS-RT Sections 5.1 wsa:DestinationUnreachable and 5.2 
wsa:EndpointUnavailable.  These faults are defined in the ws-addressing 
spec and should not be duplicated.

- Add remaining faults from WS-RT to the fault section to in WS-T. The 
merge of these faults will be subject to namespace/prefix/name changes 
agreed in the wider context of this proposal. 

- The wsrt spec explicitly states how fault properties bind to the soap 
1.1/1.2. WG needs to agree whether this is useful information or redundant 
and migrate to WST/omit accordingly.

- Create a separate issue to investigate whether it would be possible to 
combine some of the faults.  For example, wsrt:InvalidExpression may be a 
flavour of wst:InvalidRepresentation distinguished by the detail element.


Security Considerations
-----------------------

WSRT contains a subset of the security considerations contained in WST so 
no action required.


References
----------
Add references to WS-I BP 1.1 and WS-MetadataExchange that are in WSRT to 
WST.


Appendices
----------

- Add appendix B Resource Metadata Content from WSRT to T (subject to 
namespace/prefix/name changes agreed as part of rest of proposal).

- Appendix C - Combine the aspects of the XML schema in WSRT with WST's 
XML schema (again subject to global namespace changes etc)






Unless stated otherwise above:
IBM United Kingdom Limited - Registered in England and Wales with number 
741598. 
Registered office: PO Box 41, North Harbour, Portsmouth, Hampshire PO6 3AU