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

Missing citation, unnecssary repetition

    XMLWordPrintable

    Details

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

      Style

    • Proposal:
      Hide

      For all three versions, simple, technical and all-inclusive, revise to use a citation to [RFC2119], drop the URL and consider dropping the repetition of MUST, etc.

      Show
      For all three versions, simple, technical and all-inclusive, revise to use a citation to [RFC2119] , drop the URL and consider dropping the repetition of MUST, etc.

      Description

      1.2 Terminology reads in part:

      *****
      ...as described in RFC 2119 (http://www.ietf.org/rfc/rfc2119.txt).
      *****

      Shouldn't RFC 2119 be a reference to [RFC2119] which appears in your normative references? Moreover, if so, you can drop the parens and URL here.

      BTW, it isn't a big issue but I would drop the repetition of the definitions of MUST, etc. Those are already stated in RFC 2119 and nothing is gained by repeating them here.

        Attachments

          Activity

            People

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

              Dates

              • Created:
                Updated: