Details

    • Type: Bug
    • Status: Closed
    • Priority: Critical
    • Resolution: Fixed
    • Affects Version/s: OBIX 1.1 PR02
    • Fix Version/s: OBIX 1.1 WD27
    • Component/s: OBIX 1.1 Specification
    • Labels:
      None
    • Environment:

      TAB Review

    • Proposal:
      Hide

      Change language in 17 (lines 2297-2300) to clarify UML, figs, & ex are non-normative
      Add reference to the associated obix.xsd file in Section 17.

      Show
      Change language in 17 (lines 2297-2300) to clarify UML, figs, & ex are non-normative Add reference to the associated obix.xsd file in Section 17.

      Description

      "17 Conformance reads in part:


              • An implementation is conformant with this specification if it satisfies all of the MUST and REQUIRED level requirements defined herein for the functions implemented. Normative text within this specification takes precedence over normative outlines, which in turn take precedence over the XML Schema and WSDL descriptions, which in turn take precedence over examples.

      Possibly my mis-reading but this prose appears to contradict the statements in 1.6 that read in part:


              • All sections explicitly noted as examples are informational and SHALL NOT be considered normative.

      All UML and figures are illustrative and SHALL NOT be considered normative.

      I read this prose in 17 as making examples, UML and figures normative. Yes?

      BTW, the conformance clause does not mention http://docs.oasis-open.org/obix/obix/v1.1/csprd02/schemas/obix-v1.1.xsd

      The TC Process, https://www.oasis-open.org/policies-guidelines/tc-process, provides at (7a) third unnumbered bullet point that:


              • Where any definition in these separate files disagrees with the definition found in the specification, the definition in the separate file prevails.

      I realize that your ""...take precedence over the XML Schema and WSDL descriptions"" does not contradict that rule but it would be best to include the separate computer files (the XML schema and the RDDL file) as part of the conformance clause. Just to remove any ambiguity."

        Attachments

          Activity

            People

            • Assignee:
              Toby.Considine Toby Considine
              Reporter:
              Toby.Considine Toby Considine
            • Watchers:
              2 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved: