[dxwg] Scope notes for URL properties (#972)

smrgeoinfo has just created a new issue for https://github.com/w3c/dxwg:

== Scope notes for URL properties ==
In spite of the discussion in #249, #655, #740,  I think the scope notes in the current editor draft for accessURL, downloadURL and endpointURL are confusing, and the Range value 'rdfs:Resource' opens to the possibility for all kinds of incompatible/interoperable implementations that are consistent with the spec.

In all the implementation examples, the value provided for these ...URL properties is  an HTTP URI (or IRI) reference by identifier (i.e. an IRI enclosed in <>). For accessURL the reference is always to a web page; for downloadURL the reference is always to a file, for endpointURL the reference is always to a web location that will respond to properly constructed service requests.  Are there any other rdfs:Resources that could serve as valid values for these?

Is the intention to allow an in-line blank node for any rdfs:Resource, or a reference identifier for anything?

accessURL scope note states '_SHOULD be used for the URL of a service or location that can provide access to this distribution, typically through a Web form, query or API call_.'  if the dataset is accessed via API  dcat:accessService/dcat.endpointURL be used?  If the accessURL is a complete service URL that can be invoked to get the resource distribution in a response (client need know nothing about the service API or query syntax), then the resource that is the object of the property is the file that is returned, and downloadURL is more applicable.

Suggested language:
6.7.9 accessURL  An IRI reference to a web location that a human interacts with to obtain the resource distribution.  
Usage note: AccessURL SHOULD be used when the distribution can only be obtained by interacting with a landing page or web form.

6.7.11 downloadURL An IRI reference that can be dereferenced to obtain the distribution object directly.
Usage note: SHOULD be used when a web-dereferencable identifier for the distribution object is available. 

6.8.1 endpointURL.  Definition: An IRI reference to a web location that will respond to properly constructed service requests to provide access to the resource distribution.   
Usage note:  Associated endpoint description and distribution type properties provide additional information necessary for clients to obtain the desired distribution through service operations.


Please view or discuss this issue at https://github.com/w3c/dxwg/issues/972 using your GitHub account

Received on Tuesday, 2 July 2019 15:48:35 UTC