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

OBIX implementation(s) not well defined

    XMLWordPrintable

    Details

    • Proposal:
      Hide

      Based on this comment, it almost seems like we need a Glossary of Terms at the beginning, which would include these items, as well as terms like the ones that are italicized (like Object, Val, Contract, Tag, etc.)

      Show
      Based on this comment, it almost seems like we need a Glossary of Terms at the beginning, which would include these items, as well as terms like the ones that are italicized (like Object, Val, Contract, Tag, etc.)

      Description

      "
      Reading the beginning of the Conformance Clause: it talks of ""implementation"" as its very first word.
      But the only formal definition of ""implementation"" is in Contracts (""An Object which implements a Contract is said to be an implementation of that Contract."") so it naturally seems this is the ""implementation"" the conformance clause is talking about, in its introductory part. But my hunch is it is not...

      • we see ""server implementation"" at a few places. So then [OBIX] server would need to be defined, in turn.
      • we also see ""OBIX implementation"". Is it different from server implementation?
      • we also see OBIX server (and OBIX Client) here and there. But again no clear definition.
      • further in the conformance clause, we finally see: ""An implementation is a conforming OBIX Server if it meets the conditions described in Section 17.1. "". But again, that sounds circular: ""OBIX Server "" is already used before in the body of the specification, it should have a definition that does not rely on the conformance clause.

      Advice:

      • define [OBIX] Server and Client early on in the spec, based on their general function and role. Then stick to this terminology throughout.. The conformance clause can then establish their precise conformance conditions (without attempting to define these terms).
      • the whole text just at beginning of conformance section (and before 17.1 seems redundant, it is sufficient to recall what are the different types of implementations that will be dealt with (and that should be defined previously as they are used previously ).
        "

        Attachments

          Activity

            People

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

              Dates

              • Created:
                Updated:
                Resolved: