Harmonise property labels

[nicholascar]

Some of the ontology's properties start with a has-, like hasRole, hasResource but not all do, like token and the inverse properties hasProfile and profileOf don't follow the same naming pattern. Also, in some places, like the example diagrams and the RDF ontology, property names are inconsistent.

Best practice for property naming, as exemplified by the SSN ontology, is to use has- and is- across the board for present tense properties (as PROV uses was-, had- for past tense things) so the inverse of hasProfile would be isProfileOf, not just isProfile, as it currently is, and token would be hasToken.

Renaming properties would make no difference to the ontology functioning but would better indicate the purpose and direction of properties (:Profile-X prof:hasToken :Token-Y is thought to be more intuitive according to SSN & TIME etc.

If a renaming is to be made, best it is done before use (ideally before FPWD).

[nicholascar]

I have harmonised property names across all HTML, RDF & image resources, including examples in a branch. I have prepared this pull request: #532 showing the changes.

[akuckartz]

Best practice for property naming, as exemplified by the SSN ontology, is to use has- and is- across the board for present tense properties ...

I doubt that there is consensus that this is considered a "best practice".

[rob-metalinkage]

I see some pros and cons for this proposal:

pros:

• there has been a lot of discussion about what defines a profile vs what properties a profile has.. and the is/has dichotomy probably helps here
• now is the best time to make any such changes - people are looking and after it goes into the wild its harder to change
• there is no installed base we need to keep happy yet
• there is no change to the actual model

cons:

• naming conventions are probably not easily identified as best practice or not
• there is a lot of work to update ontology, diagrams, documents and examples
• implementers need to be happy with this

Given the work involved has been done (the biggest issue) and a PR generated, and Nick is an implementer, and I will also implement in a different context and have been hanging off waiting for expected name changes from FPWD feedback....

I'm inclined to support the proposal as a marginal improvement in readability - that won't delay us getting to a FPWD.

So I guess it comes down now to the group consensus on property naming styles..

It doesnt affect the readiness of the FPWG - we simply choose version 1 or 2..

We have two choices:

1. make this an issue for the plenary - i.e. vote to accept it immediately
2. accept there is no change to the model and this is editorial in nature and leave it to the Profile guidance sub-group to make the final decision and release the relevant version to W3C

[aisaac]

My recommendation on this is to get labels harmonized and discuss prefered convention later. After all, this issue is only about getting labels harmonized :-)

In any case transition to FPWD cannot result in enshrining anything like this.

[nicholascar]

Due for closing as the issue has been resolved in the now merged #532

[agbeltran]

Getting the labels harmonised is important and except for what I reported in #555 and proposed fix in #556, it should be ok in the ontology.

In terms of the names themselves, I would have preferred the shorter names (e.g. profileOf rather than isProfileOf) but this is only about naming styles preferences and indeed affects not ontology the ontology but document and diagrams, etc, so the choice of naming should be settled soon.

[agbeltran]

Actually, the document still has some misalignments with respect to the ontology:
e.g. for isProfileOf the label in the document is still profile of instead of is profile of
document: https://w3c.github.io/dxwg/profilesont/#Property:isProfileOf
ontology:

dxwg/profilesont/profilesont.ttl

Line 82 in 78a2a3d

rdfs:label "is profile of" .

[nicholascar]

Thanks @agbeltran, I have update the label "profile of" -> "is profile of".

It's perhaps not thrilling styalistically to have these longer property names but it is consistent...

[nicholascar]

Labels harmonised in document as per this date