Uploaded image for project: 'OASIS Open Building Information Exchange (oBIX) TC'
  1. OASIS Open Building Information Exchange (oBIX) TC
  2. OBIX-198

Multiple locations, the use of the word "Concept" in this specification is nearly always in muddled expressions of intent

    XMLWordPrintable

    Details

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

      Toby Considine

    • Proposal:
      Hide

      Search & reword as necessary.
      4.1.1 - The suggested language does not express the same 'concept' (sorry for the pun!) as the original text.
      4.2 - The suggested rewording seems ok
      1700 - Agree this language should be made less ambiguous as it defines a key element.
      1703-Suggested rewording sounds good.

      Show
      Search & reword as necessary. 4.1.1 - The suggested language does not express the same 'concept' (sorry for the pun!) as the original text. 4.2 - The suggested rewording seems ok 1700 - Agree this language should be made less ambiguous as it defines a key element. 1703-Suggested rewording sounds good.

      Description

      Suggest searching for all occurrences and considering re-write for each. Instances of note include:

      Section 4.1.1 Line 317: "Supports the concept of Null is awkward. Suggest "Any OBIX Objects may have the property Null."
      Section 4.2: This Concept is... Suggest: "In object-oriented terms, the base OBIX Val Object is an abstract class, and the Val subtypes are concrete classes that inherit from that abstract class.
      Line 1700: This is the normative definition of Point. Delete "The concept of"
      Line 1703-1704: "The Goal" language is distracting. Suggest:
      OBIX allows an integrator to normalize the representation of Points without forcing an impedance mismatch on implementers...

        Attachments

          Activity

            People

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

              Dates

              • Created:
                Updated:
                Resolved: