[OASIS Issue Tracker] (ODATA-1570) CSDL XML is defined with reference to XML 1.1 but none of the examples use XML version 1.1 documents

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

Evan Ireland created ODATA-1570:
-----------------------------------

             Summary: CSDL XML is defined with reference to XML 1.1 but none of the examples use XML version 1.1 documents
                 Key: ODATA-1570
                 URL: https://issues.oasis-open.org/browse/ODATA-1570
             Project: OASIS Open Data Protocol (OData) TC
          Issue Type: Bug
          Components: CSDL XML
    Affects Versions: V4.0_OS
            Reporter: Evan Ireland


(Refer to https://www.w3.org/TR/2006/REC-xml11-20060816/#sec-prolog-dtd)

Now see CSDL XML spec Section 2     XML Representation

> OData CSDL XML is a full representation of the OData Common Schema Definition Language in the Extensible Markup Language (XML) 1.1 (Second Edition) [XMLâ1.1]  ..."

None of the examples show an XML version 1.1 document (The XML 1.1 spec indicates that without an XML version in the XML declaration, the XML version is 1.0).

Example 2 shows a CSDL example without an XML declaration (so it is XML 1.0, per the XML 1.1 spec).

Example 3 shows a CSDL example with an XML declaration that specifies version=1.0.

Now per section 1.3, all examples in the CSDL XML document are non-normative and informative only.

However, none of them show a valid XML 1.1 document.

Accepting that some of the examples could be considered as partial documents (for brevity), it could be accepted that they can omit the XML declaration. But example 2 is the first example and the section title indicates it is the "CSDL XML Document", so it should not omit the XML declaration.



--
This message was sent by Atlassian Jira
(v8.3.3#803004)