[OASIS Issue Tracker] (ODATA-743) Restructure Part 3: CSDL into CSDL Core, CSDL XML, and CSDL JSON

[OASIS Issues Tracker <workgroup_mailer@lists.oasis-open.org>]

    [ https://issues.oasis-open.org/browse/ODATA-743?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=63787#comment-63787 ] 

Michael Pizzo edited comment on ODATA-743 at 10/13/16 3:47 PM:
---------------------------------------------------------------

Other option explored: have three different documents at editing stage, but merge core into XML and JSON documents for publishing.

Goals:
0) Make sure both formats define the same data model
1) Not have to mantain same text in multiple places
2) Not require someone who cares about JSON have to read XML (and vice-versa)
3) Reduce number of documents someone has to read to understand OData
4) Reduce amount of text someone has to read to understand OData

Note; if we publish separate XML and JSON, we need to make sure we correctly handle the current references from parts 1 & 2 to Part 3.


was (Author: mikep):
Other option explored: have three different documents at editing stage, but merge core into XML and JSON documents for publishing.

Goals:
1) Not have to mantain same text in multiple places
2) Not require someone who cares about JSON have to read XML (and vice-versa)
3) Reduce number of documents someone has to read to understand OData
4) Reduce amount of text someone has to read to understand OData

Note; if we publish separate XML and JSON, we need to make sure we correctly handle the current references from parts 1 & 2 to Part 3.

> Restructure Part 3: CSDL into CSDL Core, CSDL XML, and CSDL JSON
> ----------------------------------------------------------------
>
>                 Key: ODATA-743
>                 URL: https://issues.oasis-open.org/browse/ODATA-743
>             Project: OASIS Open Data Protocol (OData) TC
>          Issue Type: Improvement
>          Components: OData CSDL, OData CSDL JSON 
>    Affects Versions: V4.01_WD01
>            Reporter: Ralf Handl
>            Assignee: Ralf Handl
>              Labels: Usability
>             Fix For: V4.01_WD01
>
>
> Split the CSDL document in a "Conceptual Model" part and an "XML representation for CSDL" part, keeping "Protocol, URL, and Conceptual Model" as Core specs and having all payload format specs (XML/Atom Data, XML CSDL, JSON Data, JSON CSDL) separately



--
This message was sent by Atlassian JIRA
(v6.2.2#6258)