MUST NOT vs must not keywords

    • Type: Bug
    • Resolution: Unresolved
    • Priority: Blocker
    • None
    • Affects Version/s: Darwin Information Typing Architecture (DITA) Version 1.3 CSPRD01
    • Component/s: Public reviews
    • None
    • Environment:

      Normative

    • Hide

      Review to verify that the 11 instances of MUST NOT are the only RFC 2119 requirements for conforming DITA implementations and documents.

      If "must not" is used for such a requirement, the text should be revised to use UPPERCASE MUST NOT as per RFC 2119.

      There are 390 of "may" and 11 of "May." All of them should be checked.

      Show
      Review to verify that the 11 instances of MUST NOT are the only RFC 2119 requirements for conforming DITA implementations and documents. If "must not" is used for such a requirement, the text should be revised to use UPPERCASE MUST NOT as per RFC 2119. There are 390 of "may" and 11 of "May." All of them should be checked.

      There are 11 instances of "MUST NOT" and 3 instances of "must not."

      What is the meaning in difference of UPPERCASE versus lowercase?

      RFC 2119 says that UPPERCASE is normative and lowercase is normal usage.

      Is the difference in case intentional?

      As I noted in TAB-1264, a reader is left to wonder if MUST NOT announces all the requirements for conformance under section 4 or are some of the "must not"s meant to voice requirements as well?

      This comment applies to all three versions.

            Assignee:
            Unassigned
            Reporter:
            Patrick Durusau
            Votes:
            0 Vote for this issue
            Watchers:
            1 Start watching this issue

              Created:
              Updated: