---+ Best Practice: Use =rdfs:label= and =rdfs:comment= in RDF Vocabularies *State:* Approved *Contact:* [[https://jazz.net/wiki/bin/view/Main/NickCrossley][Nick Crossley]] ---++ Scope This Best Practice recommends appropriate usage of =rdfs:label= and =rdfs:comment= in RDF vocabularies. This Best Practice is closely related to [[UseOfRdfsLabelVersusDctermsTitle][Best Practice: When to Use =rdfs:label= Versus =dcterms:title=]] which discusses when to use similar terms defined in the [[http://dublincore.org/documents/dcmi-terms/][Dublin Core]] vocabulary. ---++ Recommendation The [[http://www.w3.org/TR/rdf-schema/][RDF Schema]] vocabulary defines the terms =rdfs:label= and =rdfs:comment=, which have a similar meaning to [[http://dublincore.org/documents/dcmi-terms/][Dublin Core]] vocabulary terms =dcterms:title= and =dcterms:description=. The RDF Schema terms SHOULD only be used in vocabulary documents. The value of =rdfs:label= SHOULD be the part of the URI that comes after the final hash or slash. The value of =rdfs:comment= should be a brief description of the term. On the other hand, the Dublin Core terms SHOULD be used in descriptions of individual document-like resources, e.g. those defined in Open Services for Lifecycle Collaboration (OSLC) specifications. =dcterms:title= SHOULD be a one line summary of the resource, e.g. the title of an article or the headline of a bug report. =dcterms:description= should be a longer description, possibly containing multiple paragraphs. If either term contains markup then the datatype MUST be XML Literal. The preferred markup for text is XHTML. Note that [[http://www.w3.org/TR/2014/REC-rdf-schema-20140225/][RDF Schema 1.1]] introduced a new literal type for HTML, so this Best Practice needs to be revised. ---++ Examples Here is an example snippet of an RDF vocabulary document: <verbatim> @prefix oslc: <http://open-services.net/ns/core#> . @prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . oslc:ServiceProvider a rdfs:Class ; rdfs:isDefinedBy oslc: ; rdfs:label "ServiceProvider" ; rdfs:comment "The Service Provider resource" ; rdfs:seeAlso <http://open-services.net/bin/view/Main/OslcCoreSpecification#Resource_Service_Provider> . </verbatim> ---++ See Also * [[http://www.w3.org/TR/rdf-schema/][RDF Schema]] * [[UseOfRdfsLabelVersusDctermsTitle][Best Practice: When to Use =rdfs:label= Versus =dcterms:title=]]
This topic: LinkedData
>
WebHome
>
BestPractices
>
UseRdfsLabelAndCommentInVocabularies
History: r4 - 2015-10-14 - 00:31:55 - Main.ndjc
Copyright © by IBM and non-IBM contributing authors. All material on this collaboration platform is the property of the contributing authors.
Contributions are governed by our
Terms of Use
Ideas, requests, problems regarding TWiki?
Send feedback
Dashboards and work items are no longer publicly available, so some links may be invalid. We now provide similar information through other means. Learn more
here
.