timrdf/prov-wg

Copy-able anchors on ns page, explicit property URI in ns page

Opened this issue · 1 comments

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:

  1. “click-able” sectioning

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.

  1. “What’s the URI”?

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

I think this is a useful extension. To the documentation