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

Conformance Clause missing normative reference

    XMLWordPrintable

    Details

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

      Conformance

    • Proposal:
      Hide

      Supply the "reference documentation" citation but if it is DocBook 5.1, best to simply omit these two sentences.

      Show
      Supply the "reference documentation" citation but if it is DocBook 5.1, best to simply omit these two sentences.

      Description

      4 Conformance reads in part:

      The reference documentation describes additional constraints and processing expectations. A conformant DocBook V5.1 document should respect those constraints and anticipate those processing expectations.

      Err, there is no "reference documentation" referenced in the conformance clause.

      By way of anticipation, DocBook 5.1 would not qualify as "reference documentation" because unlike standards it is subject to change without notice and doesn't clearly separate normative from non-normative requirements.

        Attachments

          Activity

            People

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

              Dates

              • Created:
                Updated: