[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-0003.html>
More information about the Oslc-Core
mailing list