This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.
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.
proposal at http://lists.w3.org/Archives/Public/public-ws-resource-access/2009Dec/att-0075/wsmex-8292.html.gz
Created attachment 812 [details] gil's proposal
resolved as proposed with the amendment that the sentence "A Web service endpoint MAY have one or more associated metadata resources". be retained