r4 - 2015-10-14 - 00:32:16 - NickCrossleyYou are here: TWiki >  LinkedData Web > BestPractices > UseOfRdfsLabelVersusDctermsTitle
This wiki: The development wiki is a work area where Jazz development teams plan and discuss technical designs and operations for the projects at Jazz.net. Work items often link to documents here. You are welcome to browse, follow along, and participate. Participation is what Jazz.net is all about! But please keep in mind that information here is "as is", unsupported, and may be outdated or inaccurate. For information on released products, consult IBM Knowledge Center, support tech notes, and the Jazz.net library. See also the Jazz.net Terms of Use.

New product names: The CE/CLM products were renamed in version 7.0. For details on the name change, see Renaming the IBM Continuous Engineering Portfolio. Some content might continue to use the previous names or contain a combination of the previous and current names.

Best Practice: When to Use rdfs:label Versus dcterms:title

State: Approved

Contact: Nick Crossley

Scope

This Best Practice recommends appropriate usage of the RDF Schema property rdfs:label and the Dublin Core property dcterms:title. rdfs:label and dcterms:title both provide short descriptions for resources, but they should not be used interchangeably.

This Best Practice is closely related to Best Practice: Use rdfs:label and rdfs:comment in RDF Vocabularies.

Recommendation

rdfs:label is part of the RDF Schema vocabulary and SHOULD therefore be used in vocabulary documents to describe vocabulary terms.

dcterms:title is part of the Dublin Core Metadata Initiative vocabulary and SHOULD therefore be used to describe document-like resources such as Change Requests, Requirements, Test Plans, etc. Open Services for Lifecycle Collaboration (OSLC) specifications use dcterms:title and dcterms:description.

Examples

Use rdfs:label in the following vocabulary document (in Turtle format), to define the class oslc_cm:ChangeRequest:

@prefix oslc_cm: <http://open-services.net/ns/cm#> .
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .

oslc_cm:ChangeRequest a rdfs:Class ;
    rdfs:comment "The CM Change Request resource" ;
    rdfs:isDefinedBy oslc_cm: ;
    rdfs:label "ChangeRequest" ;
    rdfs:seeAlso <http://open-services.net/bin/view/Main/CmSpecificationV2#Resource_ChangeRequest> .

Use dcterms:title in the following Plan Item 99050 document (in Turtle format), an oslc_cm:ChangeRequest resource:

@prefix dcterms: <http://purl.org/dc/terms/> .
@prefix oslc: <http://open-services.net/ns/core#> .
@prefix oslc_cm: <http://open-services.net/ns/cm#> .

<https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/99050>
    oslc:shortTitle "Plan Item 99050"^^rdf:XMLLiteral ;
    dcterms:created "2009-11-10T10:40:55.824Z"^^<http://www.w3.org/2001/XMLSchema#dateTime> ;
    dcterms:identifier "99050"^^<http://www.w3.org/2001/XMLSchema#string> ;
    dcterms:title "(Finish) CLM reporting"^^rdf:XMLLiteral ;
    dcterms:type "Plan Item"^^<http://www.w3.org/2001/XMLSchema#string> ;
    a oslc_cm:ChangeRequest .

See Also

Edit | WYSIWYG | Attach | Printable | Raw View | Backlinks: Web, All Webs | History: r4 < r3 < r2 < r1 | More topic actions
 
This site is powered by the TWiki collaboration platformCopyright © by the 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