Definition and note of prof:hasToken

[heidivanparys]

The definition and note should be updated as they start with "A property..." and "This property is ...". A definition and note should define and describe the concept the property represents, not saying that "Property X represents concept X". See e.g. guideline 4 in Guidelines for writing definitions in ontologies

E.g.
definition: profile identifier for use in APIs
note: Should be used when the Profile's URI cannot be used. For potential use in content negotiation.

[makxdekkers]

Very useful reference, thank you!
I commented on the style of definitions in the past (e.g. https://github.com/w3c/dxwg/issues/572 and #301). I suggested to use a common template "A something (with further clarification)", and leave statements about how, why and when to use it to usage notes.

[pwin]

ISO 11179 part 4 is another source of guidance on writing definitions of metadata standards terms:

http://metadata-standards.org/11179/#A4

[nicholascar]

Hi @heidivanparys,

Thanks for these comments. We are now releasing the Profiles Ontology, now Profiles Vocabulary's Second Public Working Draft. I've now flagged this Issue you've raised for consideration in time for the Third Public Working Draft.

You'll see the Issue being addressed here.

Thanks,

Nick

[nicholascar]

The definitions now in the Editor's Draft (and the 2PWD) are in line with the suggestions here although the definition has been changed to ensure the alternative-ness of the identifier, v. the URI, is indicated:

def: A preferred alternative identifier for the Profile
note: A simple lexical form of identifier that may be accepted in some circumstances, such as API arguments or in content negotiation, to reference a profile. This is a “preferred term”, since alternative identifiers may be declared and used by any implementation

@heidivanparys are you happy with these?

[heidivanparys]

@nicholascar

Yes the original issue reported (definition and note starting with "A property..." and "This property is ...") has been solved, so this issue can be closed.

Just a note: the definition in the HTML version is "The preferred identifier for the Profile, in circumstances where its URI cannot be used.", in the Turtle file it says "A preferred alternative identifier for the Profile", the same as above.

[nicholascar]

Thanks @heidivanparys for the detailed reviewing! I have aligned all the defns in HTML and RDF now and committed that to the current Pull Requests, so this will be seen to be fixed shortly.