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

Architecture Section assumes much prior and socialized knowledge

    XMLWordPrintable

    Details

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

      William Cox

    • Proposal:
      Hide

      Rewrite Section 3 addressing the order of definitions. I should be internally consistent and readable separated from the rest of the document. Do not assume that the Quick Start Section has been read.

      Validate that defined terms are used consistently through the document.

      Especially ensure consistency and flow with Section 1.8 Architectural Considerations

      Show
      Rewrite Section 3 addressing the order of definitions. I should be internally consistent and readable separated from the rest of the document. Do not assume that the Quick Start Section has been read. Validate that defined terms are used consistently through the document. Especially ensure consistency and flow with Section 1.8 Architectural Considerations
    • Resolution:
      Hide

      Rewrite Section 3.

      Show
      Rewrite Section 3.

      Description

      On addressing OBIX-156 it became obvious that the architecture section assumes prior knowledge and terminology with forward references.

      Section 3.3 defines objects and names (but mixes naming and identification somewhat). obix-195 obix-196 obix-116 address related issues.

      Some of the confusing terms are the distinctions and relationships between

      object
      resource
      contract
      REST resources
      abstractions
      implementation
      contracts and references to contracts and class definitions
      abstractions and extensibility

        Attachments

          Activity

            People

            • Assignee:
              william.cox William Cox (Inactive)
              Reporter:
              william.cox William Cox (Inactive)
            • Watchers:
              2 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved: