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

Use of "conformant"

    XMLWordPrintable

    Details

    • Type: Bug
    • Status: New
    • Priority: Minor
    • Resolution: Unresolved
    • Affects Version/s: Key Management Interoperability Protocol Profiles Version 1.3
    • Fix Version/s: None
    • Component/s: None
    • Labels:
      None
    • Environment:

      Style

    • Proposal:
      Hide

      If time permits, recast to remove the redundant "conformant" and excessive use of SHALL and other keywords outside of the conformance clauses.

      Show
      If time permits, recast to remove the redundant "conformant" and excessive use of SHALL and other keywords outside of the conformance clauses.

      Description

      It is highly redundant to keep saying "conformant" throughout the specification. You will be defining conformance when you get to the conformance clause.

      Ditto for the excessive use of SHALL.

      For example:

      3.2.4 TLS 1.2 Authentication KMIP Port Number

      You say:

      *****
      Conformant KMIP servers and clients SHALL handle the KMIP port number in in accordance with Basic Authentication KMIP Port Number (3.1.4) of the Basic Authentication Suite.
      *****

      I would say:

      *****
      KMIP servers and clients use the KMIP port number in in accordance with Basic Authentication KMIP Port Number (3.1.4) of the Basic Authentication Suite.
      *****

      Then in the conformance clause, where you list all these section anyway, A KIMP server shall (this section number and others).

      Reads much more smoothly.

        Attachments

          Activity

            People

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

              Dates

              • Created:
                Updated: