JiscSD / Canonical-data-model

Documentation for the Jisc Open Research Hub Canonical data model.
Apache License 2.0
13 stars 5 forks source link

Check scope of glossary detail is appropriate #84

Closed DomFripp closed 6 years ago

DomFripp commented 7 years ago

https://github.com/JiscRDSS/rdss-canonical-data-model/blob/master/glossary/readme.md

DomFripp commented 7 years ago

Given discussions about the distinction between semantics and the use of IDs for terminology, is the following adequate in terms of the semantic side? Changes to strings on labels and defintions will not effect message IDs.

Do we need abbreviation?

Key — a compact permanent identifier for the term, designed for computer storage rather than human readability

Label — the text string representing the term in human‐readable form

Abbreviation — a concise text string representing the term in human‐readable form where space is limited

Definition — a full description of what is meant by the term

Scope

DomFripp commented 6 years ago

Field descriptions now given within the model or in properties folder.