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

Precedence of specification conflict with TC Process

    XMLWordPrintable

    Details

    • Type: Bug
    • Status: New
    • Priority: Critical
    • 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:

      Process

    • Proposal:
      Hide

      For all three versions, simple, technical and all-inclusive, the second sentence should be deleted in its entirety.

      Show
      For all three versions, simple, technical and all-inclusive, the second sentence should be deleted in its entirety.

      Description

      1.1 XML Grammar Files reads in part:

      *****
      While the files should define the same DITA elements, the RELAX NG grammars are normative if there is a discrepancy. If there is a discrepancy between the written specification (this document) and the RELAX NG
      grammars, the written specification takes precedence.
      *****

      The last clause of the second sentence conflicts with the OASIS TC Process (7a) (https://www.oasis-open.org/policies-guidelines/tc-process#specQuality):

      *****
      For Standards Track Work Products:

      *All normative computer language definitions must be provided in separate plain text files;

      *Each text file must be referenced from the Work Product; and

      *Where any definition in these separate files disagrees with the definition found in the specification, the definition in the separate file prevails.
      *****

      The current text of DITA gives precedence to the specification over the separate plain text file.

      This is in conflict with the OASIS TC Process requirements.

        Attachments

          Activity

            People

            • Assignee:
              Unassigned
              Reporter:
              patrick Patrick Durusau
            • Watchers:
              2 Start watching this issue

              Dates

              • Created:
                Updated: