Uploaded image for project: 'OASIS Open Data Protocol (OData) TC'
  1. OASIS Open Data Protocol (OData) TC
  2. ODATA-333

Visualize high level EDM overview through means of small diagrams to aid the reader on understanding base terms

    XMLWordPrintable

    Details

    • Type: Improvement
    • Status: Closed
    • Priority: Minor
    • Resolution: Fixed
    • Affects Version/s: V4.0_WD01
    • Fix Version/s: V4.0_WD01
    • Component/s: Protocol
    • Labels:
      None
    • Environment:

      [Closed]

      Description

      This is based on my review of the latest revision [OData Core Part 1: Protocol, Version 4.0](https://www.oasis-open.org/committees/download.php/48762/odata-core-v4.0-wd01-part1-protocol-current-2013-4-5MP.docx).
      The section on entity data model must be hard to read, as it tries to describe a survival guide for a generic model, where it comes to the nitty-gritty.
      That's ok. I am fine with that. First we really need the nitty-gritty details and second we are not writing children books.
      But maybe we can do better.

      A) One problem for the astute reader seems to lie in the details of adjectives/attributes to the main terms.
      B) Another are related terms we introduce.
      C) Third the topological complexity, that cries for a parallel depict through a picture or some pictures.

      To A)
      Differentiating between an Entity and a Named Entity is one example

      To B)
      The wrapper in specific where to segragate from the Entity Container ...

      To C)
      I may volunteer to paint some maybe during the prep phase of the face to face in Walldorf as to receive early feedback and converge fast.
      Assume one for entity -> entities
      Another for relationships external and derived
      Yet another for containers and their objects (entities, actions, functions) showing also wrappers maybe as top-level hull for other "things"?

        Attachments

          Activity

            People

            • Assignee:
              Unassigned
              Reporter:
              sdrees Stefan Drees (Inactive)
            • Watchers:
              0 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved: