Consider rewording 1 Introduction, second paragraph

    • Type: Improvement
    • Resolution: Fixed
    • Priority: Minor
    • V4.0_WD01
    • Affects Version/s: V4.0_WD01
    • Component/s: CSDL XML
    • None

      In the latest revision of the [OData CSDL WD01](https://www.oasis-open.org/committees/download.php/46788/odata-csdl-v1.0-wd01-2012-08-28-RH.doc) inside
      1 Introduction, second paragraph it says:

      `An OData service SHOULD provide a CSDL description of its entity model when a client requests a description of the entity model by sending a GET request to <serviceRoot>/$metadata. $metadata MUST wrap the CSDL document in an EDMX wrapper.`

      Upon re-reading that, I propose to rewrite that paragraph as proposed.

      Benefit is "Aligning direction of causality with sentence ordering" and changing the ambivalent conditional/temporal *when* into a conditional (context free) *if*.
      The latter seems to describe more adequate the requirement, since the suggested (SHOULD) content exists regardless of a client asking for it.

      Minor point also cured:
      The pain of reading a staccato of technical individually formatted terms intermixed with natural language terms and syntax tokens like in
      `[...]sending a GET request to <serviceRoot>/$metadata. $metadata MUST wrap[...]` should be minimized to only a few places, where there exists NO correct and at the same time fluently readable "arrangement".

            Assignee:
            handl
            Reporter:
            Stefan Drees (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

              Created:
              Updated:
              Resolved: