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

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

Open
timrdf opened this Issue Jul 23, 2014 · 1 comment

Comments

Projects
None yet
2 participants
@timrdf
Owner

timrdf commented Jul 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:

  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

@timrdf timrdf added the enhancement label Jul 23, 2014

@pgroth

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