[Bug 8292] New: redundant discussions of WS-T/GetMetadata duality

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

           Summary: redundant discussions of WS-T/GetMetadata duality
           Product: WS-Resource Access
           Version: PR
          Platform: All
        OS/Version: All
            Status: NEW
          Severity: normal
          Priority: P2
         Component: MetadataExchange
        AssignedTo: public-ws-resource-access-notifications@w3.org
        ReportedBy: gilbert.pilz@oracle.com
         QAContact: public-ws-resource-access-notifications@w3.org


Section 2.2 "Example" contains (above Example 2-3) the following:

"While the WS-Policy of the Web service endpoint could be retrieved using a
WS-Transfer Get request directed to the endpoint identified by the
mex:MetadataReference element in lines 74-78 of Example 2-2, some endpoints MAY
choose to support explicit request for metadata."

This same concept (you can use WS-Transfer Get or mex:GetMetadata) is repeated
several times throughout the rest of the spec:

Section 4 "Metadata Resources":

"A Web service endpoint MAY have one or more associated metadata resources. A
Web service endpoint MAY also support direct retrieval of metadata by
requesters using a GetMetadata operation directed to the Web service endpoint
itself, as described in 6.2 Get Metadata."

Section 6.1 "WS-Transfer Get":

"To retrieve the representation of a metadata resource, a requester MAY send a
[WS-Transfer] Get request message to the metadata resource's endpoint."

Section 6.2 "Get Metadata":

"A requester MAY send a GetMetadata request message to an endpoint to retrieve
the metadata associated with that endpoint. A service endpoint MAY support the
GetMetadata request. Observe that, in the case where a service endpoint is also
a [WS-Transfer] resource, the [WS-Transfer] Get operation allows requesters to
retrieve the resource representation associated with that endpoint (i.e. the
"data"), while the GetMetadata operation can be used to retrieve that
endpoint's metadata."

Section 7 "Metadata in Endpoint References" contains the following:

"6 Retrieving Metadata describes two mechanisms that allow requesters to
retrieve ("pull metadata") Web services metadata from an endpoint (GetMetadata)
or a metadata resource (WS-Transfer Get)."

Repeating the same concepts over and over makes the spec harder to read and
creates the potential for inconsistencies.

General Proposal: Outline the concept once in an intro section then simply the
operations in 6.1 and 6.2. Remove other mentions of the concept.


-- 
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 Saturday, 14 November 2009 01:58:55 UTC