Improve structure of CSDL clause 4

XMLWordPrintable

    • Type: Improvement
    • Resolution: Fixed
    • Priority: Minor
    • V4.01_ERRATA01
    • Affects Version/s: V4.01_OS
    • Component/s: CSDL JSON, CSDL XML
    • None
    • Hide

      Reword section 4.3 along similar lines as 4.2:
      "In addition to including whole schemas with all model constructs defined within that schema, a reference may include annotations."

      Make both references to references be links to section 4.1.

      Show
      Reword section 4.3 along similar lines as 4.2: "In addition to including whole schemas with all model constructs defined within that schema,  a reference may include  annotations." Make both references to references be links to section 4.1.
    • Hide

      https://github.com/oasis-tcs/odata-specs/pull/74

      Show
      https://github.com/oasis-tcs/odata-specs/pull/74

      The subclause levels of this section suggest that Included Schema and Included Annotations are independent declarations from the $Reference declaration.  However, they should be documented as parts of the $Reference declaration.

      Related to this, 4.1 Reference asserts that it is used to bring in part of the referenced document.  However, both $Include and $IncludedAnnotations is documented as optional.  Either $Reference can bring in all of a referenced document, or at least one of $Include or $IncludedAnnotations must be specified.

      Note that edmx.xsd does not resolve this issue since it also allows the possibility that neither Include or IncludeAnnotations is specified.  

      A trivial issue is that both 'include' and 'included' are used to refer to the same functionality in this section.

            Assignee:
            george.ericson
            Reporter:
            george.ericson
            Votes:
            0 Vote for this issue
            Watchers:
            3 Start watching this issue

              Created:
              Updated:
              Resolved: