30-day Public Review for OData, OData Atom Format and OData JSON Format, V4.0 by Chet Ensign.
A great protocol is just getting better.
But, the OData TC needs your help to proof all the nooks and crannies in the latest draft:
From the email:
The OASIS Open Data Protocol (OData) TC [1] members have recently approved three Committee Specification Drafts (CSDs) and submitted them for 30-day public review:
OData Version 4.0
Committee Specification Draft 01 / Public Review Draft 01
26 April 2013OData Atom Format Version 4.0
Committee Specification Draft 01 / Public Review Draft 01
26 April 2013OData JSON Format Version 4.0
Committee Specification Draft 01 / Public Review Draft 01
26 April 2013Specification Overview:
The Open Data Protocol (OData) enables the creation of REST-based data services, which allow resources, identified using Uniform Resource Identifiers (URIs) and defined in an Entity Data Model (EDM), to be published and edited by Web clients using simple HTTP messages. OData version 4.0 defines the core semantics and facilities of the protocol, a set of recommended (but not required) rules for constructing URLs to identify the data and metadata exposed by an OData service as well as a set of reserved URL query string operators, an Entity Data Model (EDM), and an XML representation of the entity data model exposed by an OData service.
OData Atom Format version 4.0 extends the former by defining representations for OData requests and responses using an Atom format.
OData JSON Format version 4.0 extends the former by defining representations for OData requests and responses using a JSON format.
TC Description:
The OASIS OData TC works to simplify the querying and sharing of data across disparate applications and multiple stakeholders for re-use in the enterprise, Cloud, and mobile devices. A REST-based protocol, OData builds on HTTP, AtomPub, and JSON using URIs to address and access data feed resources. It enables information to be accessed from a variety of sources including (but not limited to) relational databases, file systems, content management systems, and traditional Web sites. OData provides a way to break down data silos and increase the shared value of data by creating an ecosystem in which data consumers can interoperate with data producers in a way that is far more powerful than currently possible, enabling more applications to make sense of a broader set of data. Every producer and consumer of data that participates in this ecosystem increases its overall value.
Public Review Period:
The public review starts 03 May 2013 at 00:00 GMT and ends 02 June 2013 at 23:59 GMT.
Practice your reading/proofing skills:
The prose specification document and related files are available here:
– OData Version 4.0
OData Version 4.0 is a multi-part Work Product consisting of:
— OData Version 4.0 Part 1: Protocol.
Editable Source (Authoritative):
http://docs.oasis-open.org/odata/odata/v4.0/csprd01/part1-protocol/odata-v4.0-csprd01-part1-protocol.doc— OData Version 4.0 Part 2: URL Conventions.
Editable Source (Authoritative):
http://docs.oasis-open.org/odata/odata/v4.0/csprd01/part2-url-conventions/odata-v4.0-csprd01-part2-url-conventions.doc— OData Version 4.0 Part 3: Common Schema Definition Language (CSDL).
Editable Source (Authoritative):
http://docs.oasis-open.org/odata/odata/v4.0/csprd01/part3-csdl/odata-v4.0-csprd01-part3-csdl.docHTML:
http://docs.oasis-open.org/odata/odata/v4.0/csprd01/part3-csdl/odata-v4.0-csprd01-part3-csdl.htmlPDF:
http://docs.oasis-open.org/odata/odata/v4.0/csprd01/part3-csdl/odata-v4.0-csprd01-part3-csdl.pdf— ABNF components – OData ABNF Construction Rules Version 4.0 and OData ABNF Test Cases:
http://docs.oasis-open.org/odata/odata/v4.0/csprd01/abnf/— OData Metadata Service Entity Model:
http://docs.oasis-open.org/odata/odata/v4.0/csprd01/models/MetadataService.edmx— Vocabulary components – OData Core Vocabulary and OData Measures Vocabulary:
http://docs.oasis-open.org/odata/odata/v4.0/csprd01/vocabularies/— XML schemas – OData EDMX XML Schema and OData EDM XML Schema:
http://docs.oasis-open.org/odata/odata/v4.0/csprd01/schemas/– OData Atom Format Version 4.0
Editable Source (Authoritative):
http://docs.oasis-open.org/odata/odata-atom-format/v4.0/csprd01/odata-atom-format-v4.0-csprd01.docHTML:
http://docs.oasis-open.org/odata/odata-atom-format/v4.0/csprd01/odata-atom-format-v4.0-csprd01.htmlPDF:
http://docs.oasis-open.org/odata/odata-atom-format/v4.0/csprd01/odata-atom-format-v4.0-csprd01.pdfOData Metadata XML Schema:
http://docs.oasis-open.org/odata/odata-atom-format/v4.0/csprd01/schemas/metadata.xsdOData Atom Vocabulary:
http://docs.oasis-open.org/odata/odata-atom-format/v4.0/csprd01/vocabularies/Org.OData.Atom.V1.xml– OData JSON Format Version 4.0
Editable Source (Authoritative):
http://docs.oasis-open.org/odata/odata-json-format/v4.0/csprd01/odata-json-format-v4.0-csprd01.docHTML:
http://docs.oasis-open.org/odata/odata-json-format/v4.0/csprd01/odata-json-format-v4.0-csprd01.htmlPDF:
http://docs.oasis-open.org/odata/odata-json-format/v4.0/csprd01/odata-json-format-v4.0-csprd01.pdfZIP distribution file (complete):
For your convenience, OASIS provides a complete package of the prose specifications and related files in ZIP distribution files. You can download the ZIP files here:
– OData Version 4.0:
http://docs.oasis-open.org/odata/odata/v4.0/csprd01/odata-v4.0-csprd01.zip– OData Atom Format Version 4.0:
http://docs.oasis-open.org/odata/odata-atom-format/v4.0/csprd01/odata-atom-format-v4.0-csprd01.zip– OData JSON Format Version 4.0:
http://docs.oasis-open.org/odata/odata-json-format/v4.0/csprd01/odata-json-format-v4.0-csprd01.zipAdditional information about the specifications and the OASIS Open Data Protocol (OData) TC can be found at the TC’s public home page:
https://www.oasis-open.org/committees/odata/
Comments may be submitted to the TC by any person through the use of the OASIS TC Comment Facility by following the instructions located via the button labeled "Send A Comment" at the top of the TC public home, or directly at:
https://www.oasis-open.org/committees/comments/index.php?wg_abbrev=odata
Comments submitted by TC non-members for this work and for other work of this TC are publicly archived and can be viewed at:
https://lists.oasis-open.org/archives/odata-comment/
All comments submitted to OASIS are subject to the OASIS Feedback License, which ensures that the feedback you provide carries the same obligations at least as the obligations of the TC members. In connection with this public review of "OData, OData Atom Format and OData JSON Format, Versions 4.0", we call your attention to the OASIS IPR Policy [2] applicable especially [3] to the work of this technical committee. All members of the TC should be familiar with this document, which may create obligations regarding the disclosure and availability of a member’s patent, copyright, trademark and license rights that read on an approved OASIS specification.
OASIS invites any persons who know of any such claims to disclose these if they may be essential to the implementation of the above specification, so that notice of them may be posted to the notice page for this TC’s work.
========== Additional references:
[1] OASIS Open Data Protocol (OData) TC
http://www.oasis-open.org/committees/odata/[2] http://www.oasis-open.org/who/intellectualproperty.php
[3] http://www.oasis-open.org/committees/odata/ipr.php
https://www.oasis-open.org/policies-guidelines/ipr#s10.2.2
RF on RAND Mode
Don’t comment here!
Comments go to odata-comment.
Thanks!
(Full disclosure: I am a member of the OData TC. Just like you I have a lot of reading ahead of me.)