Skip to content

Consolidate label, description, note, usageNote and example #461

@jesper-friis

Description

@jesper-friis

Problem: Label, description, note, usageNote and example seems to be the basic terms for defining a concept and are commonly used in standardisation documents. However, there exists many slightly different vocabularies and ontologies that definition variants of these basic terms. This creates confusion when documenting a list of concepts defined in different vocabularies/ontologies in a tabular form.

Suggestion: Map these terms to corresponding concepts in existing vocabularies and ontologies.

Requiremets: Provide a default mapping for convenience. But the user should be able to provide their own mappings.

Possible default mappings:

  • label: rdfs:label, skos:prefLabel
  • description: rdfs:comment, dcterms:description, skos:definition, emmo:elucidation
  • note: skos:note, emmo:comment, emmo:conceptualisation
  • usageNote: skos:scopeNote, vann:usageNote
  • example: skos:example

Possible implementation: Consider to use define the mappings using SSSOM.

Questions: Do we need all 5 terms? Usage note was included because it is used in the DCAT documentation. However, standardisation documents like ISO, CWA, VIM does not have 'usageNote'. Do we need it, or should it just be a 'note'?

Reversely, skos defines a set of other concepts that one could consider to include:

  • skos:altLabel
  • skos:hiddenLabel
  • skos:changeNote
  • skos:editorialNote
  • skos:historyNote

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions