Title Deprecate certain v2 methods for resource preview
Description
1. Preview Discovery

To preserve compatibility with OSLC2, preview discovery must continue to support the Accept: application/x-oslc-compact+xml header to get the Compact resource. This usage will be noted as deprecated. OLSC3 clients should use the Link header with rel="http://open-services.net/ns/core#Compact" and the Prefer header with include="http://open-services.net/ns/core#PreferCompact”, using the Accept header with standard MIME types such as text/turtle, application/rdf+xml, application/ld+json, etc. to get the Compact resource in the desired format.

2. Preview Resource Representation 

OSLC3 must continue to support the OSLC2 Compact resource XML representation. This format will be noted as deprecated. OSLC3 clients should use the Accept and Prefer headers to get the compact resource in Turtle or JSON format. Servers may support other formats such as application/rdf+xml and application/ld+json.

3. Preview Resize

OSLC3 will continue to support the OSLC2 oslc-preview-height resize message, but this usage will be noted as deprecated. OSLC3 servers should use the oslc-resize message. OSLC3 servers should send both the oslc-preview-height and oslc-resize messages if OSLC2 compatibility is a requirement.

This results in very few changes to Resource Preview - just including the x- MIME type and XML format for the OSLC2 Compact resource, and handling the oslc-preview-height resize message for OSLC2 compatibility.
Ballot Options Ballot has closed
[ ] Yes
[ ] No
[ ] Abstain
Opening Date Wed, Jul 29 2015 12:00 pm EDT
Closing Date Thu, Jul 30 2015 8:22 am EDT
Ballot has closed.

Referenced Items

Name Type Date Actions