Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.
Sign upComments
timrdf
added
the
enhancement
label
Jul 23, 2014
This comment has been minimized.
This comment has been minimized.
pgroth
commented
Dec 9, 2018
I think this is a useful extension. To the documentation |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
timrdf commentedJul 23, 2014
http://www.w3.org/ns/prov#atLocation works, but there is no "copy-able link" that can be helpful when browsing the page and wishing to send someone a reference to a particular section.
This feature appears in PROV-O at e.g. http://www.w3.org/TR/prov-o/#atLocation (the text prov:atLocation is a link).
Original descriptions:
The anchor for http://www.w3.org/ns/prov#Activity lands into the HTML section about the class, but I find it reassuring when I can click on the section title to get that URL into my browser, so that I can share that specific section with people. Clickable section titles tells the reader “this is worth sharing!”. I had to manually add “#Activity” to the URL to get to that section.
For example, http://www.w3.org/TR/prov-o/#Activity has a link in “(2) Class: prov:Activity” to get to that same section.
When one gets to the HTML http://www.w3.org/ns/prov#Activity, it’s confusing what the URI for prov:Activity actually is. Although the reader “is actually there” and we’re using content negotiation as we should, that is rarely the case for ontology documentation (e.g., prov-o’s TR documentation URLs aren't actually the URIs for the terms), which leaves the reader to wonder which URI to use [1,2,3,4] — which is NONE of them :-/. I think it would be a very good idea to reinforce what the URI for prov:Activity actually is within the HTML section at http://www.w3.org/ns/prov#Activity. For example, prov-o just calls it out:
IRI:http://www.w3.org/ns/prov#Activity
[1] http://www.w3.org/TR/2013/REC-prov-o-20130430/#Activity
[2] http://www.w3.org/TR/2013/NOTE-prov-xml-20130430/#term-Activity
[3] http://www.w3.org/TR/2013/REC-prov-dm-20130430/#term-Activity
[4] http://www.w3.org/TR/2013/REC-prov-n-20130430/#prod-activityExpression