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

Mistatement of the nature of normative references

    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:

      References

    • Proposal:
      Hide

      Delete the line:

      *****
      Normative references are references to external documents or resources to which implementers of DITA MUST comply.
      *****
      Use specific references to portions of normatively cited specifications to require conformance to defined portions of those specifications.

      Show
      Delete the line: ***** Normative references are references to external documents or resources to which implementers of DITA MUST comply. ***** Use specific references to portions of normatively cited specifications to require conformance to defined portions of those specifications.

      Description

      1.3 Normative References reads in part:

      *****
      Normative references are references to external documents or resources to which implementers of DITA MUST comply.
      *****

      As it reads, all implementers of DITA must conform to SVG 1.1 for example. As I read SVG 1.1, http://www.w3.org/TR/SVG/conform.html, it offers a fairly complex matrix of possible conformances and simply using an external reference does not put implementers on notice of what they are being required to do to conform to the DITA standard.

      The usual listing of normative references is a citation list that is used later to refer implementers to particular parts of the normative reference to which they must conform. For example, if a DITA viewer must support SVG to conform to this standard (I don't know, I haven't read ahead), then at the appropriate place, you would reference the definition of a conforming SVG viewer, in SVG 1.1 and the implementer would know what is being required of them.

        Attachments

          Activity

            People

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

              Dates

              • Created:
                Updated: