Uploaded image for project: 'Technical Advisory Board'
  1. Technical Advisory Board
  2. TAB-1652

In conformance section, normative statements are confused with "conformance clause"

    XMLWordPrintable

    Details

    • Type: Bug
    • Status: New
    • Priority: Major
    • Resolution: Unresolved
    • Affects Version/s: OSLC Query Version 3.0
    • Fix Version/s: None
    • Component/s: Public reviews
    • Labels:
      None
    • Environment:

      Conformance

      Description

      In the conformance section, we read:  "Implementations of this specification need to satisfy the following conformance clauses." But what follows is just a recap of the normative requirements in the specification body. If you replace in this sentence "...the following conformance clauses" with "...the following normative requirements" it would be correct. The whole content of section 10 becomes then a single conformance clause.

      It is good to refer to normative requirements, but a conformance clause is something different. It should say something like "In order to conform [ as an OSLCv3 server], an OSLC implementation must satisfy this set of normative statements [ here provide a list or a reference to the section in spec body that contains them]." The clause is more general. Its focus is the implementation and under which conditions it conforms. It may tighten a SHOULD into a MUST for a higher level of conformance. The clause should have a name.

      See the conformance clauses guidelines on TAB page: https://www.oasis-open.org/committees/tc_home.php?wg_abbrev=tab  (guideline doc on conformance clauses: http://docs.oasis-open.org/templates/TCHandbook/ConformanceGuidelines.html )

       

        Attachments

          Activity

            People

            • Assignee:
              Unassigned
              Reporter:
              jdurand2 Jacques Durand (Inactive)
            • Watchers:
              1 Start watching this issue

              Dates

              • Created:
                Updated: