-
Notifications
You must be signed in to change notification settings - Fork 55
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
Link to the Resource Roles vocab in the Profiles Ont doc #536
Comments
At this stage just add it in the same place as the rest, please! |
I agree that the roles should go in the profiles ontology doc. |
I have seen several scenarios where code lists are published within a spec "to be extended" but then never are: ISO19115 (old and new versions), IGSN models with sample type and others. People wanting to extend the lists have no go-to place close to the spec to publish extensions for others to reuse. Here we want to initially publish a vocab independently (at least a different doc) from the ontology so that it is able to grow in place. Then it will be obvious how and where new terms can be added. The W3C might implement tooling for good vocab publication soon but even as a simple HTML & RDF pair of text documents this vocab will be easy enough to grow, as long as its allowed to for which it can't be in the ontology doc which will be locked down. |
I'm going to agree with @aisaac - a list of clearly obvious roles should at least be included in the document. For the FPWD the current roles could be listed and that would elicit feedback. Anything that is not in the document is less likely to be seen and commented on. That they are in the FPWD document does not determine where they could be in future versions. |
@nicholascar I would add that creating a place for people to put extensions can be done besides adding a set of roles in the main spec. You can still create your extension place besides the main spec, as Web Annotation have done. In any case like @kcoyle I am not 100% against having roles outside of the main spec in the end. It's just that for the moment (1) it is much simpler to have them in (2) we have not seen the W3C-supported extension mechanism yet and frankly I wouldn't put a dollar on it until I've seen some concrete plans. |
A compromise might be to both list instances of Resource Roles in the Resource Role definition and examples using real Resource Role instances in the ontology. This way, real Roles are present in the ontology for discovery and use, along with lists to the full and growing vocabulary of all Roles, but we head off "the 'first, DXWG born' roles and the others" which is, indeed, my main goal here. The SSN Ontology give examples of Results, see https://www.w3.org/TR/vocab-ssn/#Results "The following examples illustrate how the terms related to Results can be used:", linked from there https://www.w3.org/TR/vocab-ssn/#iphone_barometer-sosa, https://www.w3.org/TR/vocab-ssn/#coil_oil_plant-sosa etc. |
Looking at the SSN document, the roles are not even described. I don't know what the intention of that document is in relation to roles but I don't see it as analogous to profont, where the roles are really essential to the purpose of the ontology. I still vote for a list of initial roles in the FPWD, and we'll see how they play out for the final document. But I can't imagine that even the final document won't have a strong treatment of the roles. |
@nicholascar I'll need your help as I'm not familiar with SSN. It seems the results there are a whole module/extension with its own classes and properties too, isn't it? |
Yes, the SSN ont has such an extension. The Reference to the SOSA document wasn't to suggest that Roles might be a module within PROF - just a vocab - but the reference was just to show another W3C document referring to non-normative individuals in examples.
It would indeed be legitimate but is it preferable? I think not, given the static nature (after completion) of the ontology but the dynamic nature of an extensible roles list.
Indeed. You would see that a I don't anticipate "a (non-normative) set of classes and properties specifically dedicated to describe roles with more details" really, just a listing of individual Roles (with SKOS properties such as prefLabel etc.) but it's just a vocab, not an ontology module. |
OK so if there's not a full module this also means that the price to include some roles in the nromative part is very small. I really, really don't see the point of making everyone's life (especially the one of the reader of the spec) more complex at this stage. Again:
|
This Issue's initial issue - linking to the vocab - is complete and the final point raised here is discussion about the existence of the Roles vocab overall. This latter point is also contained in Issue #535 so I recommend shutting this Issue to contain discussion about the exitence of the Roles vocab in Isseu #535 only. |
I wonder whether part of the discussion was about allowing people to add new roles in the future under the same |
+1 for @nicholascar on closing this issue, but only after @andrea-perego has put his comment at #535 ;-) |
@aisaac wrote:
Done! #535 (comment) |
Currently the Resource Roles vocab is referenced in the Prof Ont doc (see last para https://w3c.github.io/dxwg/profilesont/#introduction) but no actual link is given. PR 532 brings the Resource Roles vocab into W3C styling and updates it so now a link to that doc needs to be added.
The reason for this whole issue here is that how it is referenced needs discussion. If it is to be a NOTE, how will this impact future re-publication of it as a dynamic vocab, not a static document?
The text was updated successfully, but these errors were encountered: