New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
CURIEs and "working links" #12
Comments
Thank you, Erik. Disclaimer: the text of the spec may indeed be misleading, always a possibility, however the intention of the spec is as follows:
I believe this intent is compliant with your suggestion that there shouldn't be any assumption of URI being dereferenceable.... that said - having a preference of it being dereferenceable and making default extension/CURIE both dereferenceable and self-documenting is not a violation and I think is a positive thing. |
On 2017-12-28 15:34, Irakli Nadareishvili wrote:
2. URIs in object attributes and link rels MAY be dereferenceable, but
doesn't have to be.
good. i'd make that explicit.
3. Any URI anywhere in the document MAY be CURIEd
any, not just *any hyper*? JSON doesn't even have a URI type, so i think
you wouldn't even know which ones are supposed to be URIs or may just
look like one, right?
4. If a URI in attribute names and link rels is dereferenceable it
SHOULD point to a resource that provides information about the
semantics and proper usage of the corresponding Hyper extension
and/or link relation. This, howevers, is not strictly required
because the URI may be just establishing the namespace and
corresponding semantics and rule can be explained elsewhere, out of
band e.g. in a encyclopedia :)
i would keep this short and sweet. just say that URIs may be used for
identification and optionally documentation, but that any further
details about that latter part are out of scope.
5. If link is dereferenceable authors of the extensions MAY use
content-negotiation to provide information in a variety of formats
(e.g. human-friendly HTML and machine-friendly ALPS)
as said above: short and sweet and anything here seems out of scope.
6. Hyper parsers MUST assume default extension |h: ->
http://hyperjson.io/props| and all items in that vocabulary are
linked to by dereferenceable URIs, and those URIs do explain usage
rules.
i like XML's rule of defining the "xml" prefix as magically present, but
to also allow instances to make it explicit. it keeps things nicely
consistent with a minimum of magic.
I believe this intent is compliant with your suggestion that there
shouldn't be any assumption of URI being dereferenceable.... that said -
having a /preference/ of it being dereferenceable and making default
extension/CURIE both dereferenceable and self-documenting is not a
violation and I think is a positive thing.
maybe. from what i see it seems to create more confusion than anything
else, starting with XML namespaces which started this pattern.
|
currently the spec makes the same mistake as HAL, mixing the idea of URIs for identification, and for dereferencing. i would expect CURIEs strictly to be used so that URI-identified properties can be written in an abbreviated form.
however, the spec currently jumps to the idea that i can dereference that URI and get a property's definition/description. that's something entirely different. the spec should be clear about whether properties are simply just identified by URI, and whether there is any assumption about that URI being one that dereferences to a definition/description.
The text was updated successfully, but these errors were encountered: