[oslc-core] oslc v2.0 spec - observed issue with oslc:shorttitle description

Jacob Yackenovich jyackeno at us.ibm.com
Thu Sep 1 16:05:35 EDT 2011


Hi Team,
        In reviewing the OSLC Core spec contents, I've observed some level 
of ambiguity with two declarations of the use of oslc:shorttitle

Open Services for Lifecycle Collaboration Core Specification Version 2.0 
UI Preview:
http://open-services.net/bin/view/Main/OslcCoreUiPreview?sortcol=table;up=#Representing_a_Resource_for_UI_P

provides a definition of oslc:shortTitle with a value-type of "XMLLiteral" 
and a description of:
"Abbreviated title which may be used in the display of a link to the 
resource. The value SHOULD include only content that is valid inside an 
XHTML <span> element. Providers SHOULD include an abbreviated title for 
the resource when possible. The abbreviated title is typically shown to a 
user as a hyperlink in presentations where visual space is limited. As a 
general guideline, the length of the abbreviated title SHOULD be 5 
characters or less. A user-visible identifier that ordinarily appears in 
the dcterms:title, such as a defect number, makes for a good 
oslc:shortTitle value. When a resource has no obvious identifier or 
handle, Providers SHOULD omit the oslc:shortTitle property. "

My issue is with regard to the length statement. I am not aware of many 
well-balanced self-contained XML values that would be meaningful and also 
fit in the boundary of 5 characters or less. 


In addition, the Open Services for Lifecycle Collaboration Core 
Specification Version 2.0 Appendix A: Common Properties: 
http://open-services.net/bin/view/Main/OSLCCoreSpecAppendixA

Provides the following definition for oslc:shortTitle with a value-type of 
"XMLLiteral" and a description of:
"Shorter form of dcterms:title for the resource represented as rich text 
in XHTML content. SHOULD include only content that is valid inside an 
XHTML <div> element. "


My additional issue is the apparent ambiguity between the descriptions of 
shortTitle. I may adhere to the best practices of the description of the 
Core declaration for this property, however in doing so I will (quite 
possibly) violate the best practices listed in the UI Preview 
specification for this property.

Further, there is a discrepancy as to what content is valid the property. 
UI Preview best practice is content SHOULD be valid inside an XHTML <span> 
element, while Core best practice is SHOULD be valid inside an XHTML <div> 
element.

Could you investigate and suggest a course of action to reconcile the 
descriptions of oslc:shortTitle between the core specifications? 



Regards,
Jacob

Jacob Yackenovich
Data Integration Lead, Common Data Model Architecture 
Tivoli Software |  IBM  |  Research Triangle Park, NC
jyackeno at us.ibm.com  |  (919) 224-1373
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://open-services.net/pipermail/oslc-core_open-services.net/attachments/20110901/f3ccc7ec/attachment.html>


More information about the Oslc-Core mailing list