[OASIS Issue Tracker] (ODATA-911) MIscellanous feedback (public comment c201602e00000)

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

Ralf Handl created ODATA-911:
--------------------------------

             Summary: MIscellanous feedback (public comment c201602e00000)
                 Key: ODATA-911
                 URL: https://issues.oasis-open.org/browse/ODATA-911
             Project: OASIS Open Data Protocol (OData) TC
          Issue Type: Bug
          Components: OData JSON CSDL
    Affects Versions: V4.0_CSD01
            Reporter: Ralf Handl
             Fix For: V4.0_CSD02


Public Review Comment https://lists.oasis-open.org/archives/odata-comment/201602/msg00003.html.

Summary
- 4.1.1 prose text describing structure of "keys" array doesn't match example 6 
(editor's note: example is correct, prose text is garbled)

- 4.1.2.5 Nullable Properties, Example 36: "format":"decimal" seems to be missing
(editor's note: it is missing, should be there according to table in 4.1.2.1)

- a flag "nullable" would avoid the need to reverse-engineer this information from the type array tailored for validators
(editor's note: this is currently discussed for Swagger, see https://github.com/OAI/OpenAPI-Specification/issues/229)

- 4.5.3.2 Path Expressions: The 2nd list does not contain @odata.navigationPropertyPath
(editor's note: needs to be added)

- 4.5.3.6 Expression Apply: mismatch between prose text and example

- 4.5.3.10 Expression Not: can this contain annotations?

- 4.5.3.11 Expression Null: Why do annotations not live next to @odata.null, like it is the case for @odata.if etc.? Comment gives two proposals for a simpler syntax

- 4.5.3.12 Expression UrlRef: The text does not fit to the example, but I think the example is better and should win ;-)
(editor's note: agreed :-)




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