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

COnformance targets need better up-front definitions

    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

      Although the conformance clause(s) do a good job distinguishing conformance targets, these have been mentioned many times before the conformance clauses, without much of a definition. For example, "DITA processor" is used abundantly throughout the specification, but I could not find a definition of what it is (even if we can guess intuitively).
      A functional definition should be introduced/referred to much earlier - e.g. terminology or glossary - before the conformance clause(s).
      Similarly, the term "implementation" is used throughout, but not clearly functionally defined. Only in the conformance clauses we find a tentative definition, which is a bit hard to distinguish from "processor". Couldn't the notion of processor cover such "implementations"? Normally, "implementation" is a generic term that covers all kinds of ways to implement a specification - here to implement DITA including DITA documents.

        Attachments

          Activity

            People

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

              Dates

              • Created:
                Updated: