• Type: Bug
    • Resolution: Fixed
    • Priority: Major
    • None
    • Affects Version/s: None
    • Component/s: Public Review
    • None
    • Hide

      1) Make the first paragraph of section 2 into a sub-section.
      2) Change "this document specifies" to "this specification defines".
      3) Delete the word "typically" from "is typically the interface".

      The remainder of the concerns are obviated by the resolution of CAMP-99.

      Show
      1) Make the first paragraph of section 2 into a sub-section. 2) Change "this document specifies" to "this specification defines". 3) Delete the word "typically" from "is typically the interface". The remainder of the concerns are obviated by the resolution of CAMP-99 .

      Patrick Durusau submitted the following PR comment (https://lists.oasis-open.org/archives/camp-comment/201309/msg00019.html):

      Section 2 begins with this paragraph:

      *****
      This document specifies the self-service management API that a
      Platform as a Service offering presents to the consumer of the
      platform. The API is typically the interface into a platform
      implementation layer that
      controls the deployment of applications and their use of the platform.
      *****

      "This document...?" cut-n-paste error?

      "...is typically the interface..." ?

      Two issues:

      1) Hanging paragraphs - If this part of 2 is non-normative (typically)
      then how do we declare it? If 2 Concepts and Types is declared to be
      non-normative, does that extend to all of 2?

      I mention that because there is requirements language (SHALL and SHALL
      NOT) that occurs in the paragraph prior to 2.2 Deployment.

      Declaring all of 2 non-normative would exclude those statements from
      the normative portion of the text.

      2) Section 2 reads like non-normative text but as per the existing
      rule on non-normative text, it is now normative.

      I hesitate because normative text doesn't use terms like "typically."
      I can't conform to "typically."

            Assignee:
            Gilbert Pilz (Inactive)
            Reporter:
            Gilbert Pilz (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

              Created:
              Updated:
              Resolved: