OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

odata message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: Starter Documents for OData Version 4.0 Errata 01 and OData JSON Format Version 4.0 Errata 01


Per the TC's submission requests [1], please find the attached starter documents for: 
OData Version 4.0 Errata 01 and
OData JSON Format Version 4.0 Errata 01

These starter documents (templates) are intended for use in preparing listings of the specific changes which are being made to the OASIS Standards.

Most users of the Standards will also benefit from a change-marked "complete" version of the Errata, in addition to the listings. Although this is optional according to the OASIS TC Process [2], OASIS TC Administration encourages TCs to produce a complete change-marked version of the OS including the Errata. For the multi-part OData v4.0, this will require re-publication of all parts, even those which may not be changed by Errata.

In order to produce the change-marked version, the TC should begin with the published OASIS Standard files [3], and make the necessary changes, while using the "Track changes" capability of the word processor.  The TC should not make any changes above the Table of Contents; OASIS TC Administration will make the necessary modifications to the Front Matter.

Basic process for producing Errata (from the TC Process [2]):
1 - publish as a CSD (as a list of changes (one document), optionally accompanied by a change-marked copy of the OASIS Standard)
2 - confirm by vote that the Errata do not constitute a substantive change, and submit for a Public Review
3 - after the Public Review, vote to adopt as "Approved Errata"

Please let me and/or Chet Ensign know if you have any questions. We're happy to help guide you through this process.

[1] https://tools.oasis-open.org/issues/browse/TCADMIN-1743
     https://tools.oasis-open.org/issues/browse/TCADMIN-1744
[2] https://www.oasis-open.org/policies-guidelines/tc-process#errata
[3] Source files for OData Version 4.0 OASIS Standard:
     http://docs.oasis-open.org/odata/odata/v4.0/os/part1-protocol/odata-v4.0-os-part1-protocol.doc
     http://docs.oasis-open.org/odata/odata/v4.0/os/part2-url-conventions/odata-v4.0-os-part2-url-conventions.doc
     http://docs.oasis-open.org/odata/odata/v4.0/os/part3-csdl/odata-v4.0-os-part3-csdl.doc
     Source file for OData JSON Format Version 4.0 OASIS Standard:
     http://docs.oasis-open.org/odata/odata-json-format/v4.0/os/odata-json-format-v4.0-os.html

Best wishes,
Paul

P.S.  Details on the expected directory structure for OData v4.0 Errata (multi-part):

Listing of Errata for all parts (in one document):
http://docs.oasis-open.org/odata/odata/v4.0/errata01/csd01/odata-v4.0-errata01-csd01.doc

directory:
http://docs.oasis-open.org/odata/odata/v4.0/errata01/csd01/
- will contain:
odata-v4.0-errata01-csd01.doc
odata-v4.0-errata01-csd01.html
odata-v4.0-errata01-csd01.pdf
- any other modified files (abnf, models, schemas, or vocabularies)


How will it be handled if a "complete" change-marked (multi-part) version is produced?

The files will all be under the directory:
http://docs.oasis-open.org/odata/odata/v4.0/errata01/csd01/complete/

This "complete" directory will have the usual subdirectories for the parts, each with the multiple formats (.doc, .pdf, .html) of the prose document for the part. 

It will also have the directories for the other files (abnf, models, schemas, and vocabularies).

So there will be:
http://docs.oasis-open.org/odata/odata/v4.0/errata01/csd01/complete/part1-protocol/odata-v4.0-errata01-csd01-part1-protocol.doc (.html, .pdf)
http://docs.oasis-open.org/odata/odata/v4.0/errata01/csd01/complete/part2-url-conventions/odata-v4.0-errata01-csd01-part2-url-conventions.doc (.html, .pdf)
http://docs.oasis-open.org/odata/odata/v4.0/errata01/csd01/complete/part3-csdl/odata-v4.0-errata01-csd01-part3-csdl.doc (.html, .pdf)
http://docs.oasis-open.org/odata/odata/v4.0/errata01/csd01/complete/abnf/
http://docs.oasis-open.org/odata/odata/v4.0/errata01/csd01/complete/models/
http://docs.oasis-open.org/odata/odata/v4.0/errata01/csd01/complete/schemas/
http://docs.oasis-open.org/odata/odata/v4.0/errata01/csd01/complete/vocabularies/

--
Paul Knight  - Tel: +1 781-861-1013
OASIS - Advancing open standards for the information society
Document Process Analyst

Attachment: odata-v4.0-errata01-wd01.doc
Description: MS-Word document

Attachment: odata-json-format-v4.0-errata01-wd01.doc
Description: MS-Word document



[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]