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

Conformance language is weak and vague at times

    XMLWordPrintable

    Details

    • Type: Bug
    • Status: New
    • Priority: Major
    • Resolution: Unresolved
    • Affects Version/s: Darwin Information Typing Architecture (DITA) Version 1.3 CSPRD01
    • Fix Version/s: None
    • Component/s: Public reviews
    • Labels:
      None
    • Environment:

      Conformance

      Description

      The conformance clause must be more affirmative and avoid vague wording:
      "In general, specialization-aware processors will be able to reliably process all conforming DITA documents,..."
      avoid the use of "should" in conformance clause:
      "Such processors SHOULD implement filtering."
      It is OK in the normative body of the specification, but the conformance clause is supposed to remove any ambiguity, as much as possible. "processors SHOULD implement filtering" has its place in the body of the specification, but if it matters to conformance, the clause either can override Should as a Must, or the feature has to be a conformance option that must be part of the claim (see commentt #1286)

        Attachments

          Activity

            People

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

              Dates

              • Created:
                Updated: