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:

      Style

    • Proposal:
      Hide

      Correct all instances of "can" to either MAY or may (if not a requirement).

      Show
      Correct all instances of "can" to either MAY or may (if not a requirement).

      Description

      The comprehensive draft has 1129 instances of "can," where you could say "MAY."

      Careful readers aren't going to pick up on "can" because you defined the requirement terms as RFC 2119.

      For example: 2.3.4.2 Key scopes reads in part:

      *****
      Each key scope has its own key space that is used to resolve the key references that occur within the scope. The key space that is associated with a key scope includes all of the key definitions within the key scope. This means that different key scopes can have different effective key definitions:
      *****

      I assume the "can" marked in that passage is actually a "MAY" and as such is a requirement for DITA processors to honor. Yes?

        Attachments

          Activity

            People

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

              Dates

              • Created:
                Updated: