search

IETF-OPSAWG-WG / draft-ietf-opsawg-pcap

PCAP next generation file format specification
Other
267 stars 60 forks source link

A minor edit to avoid redundant language #127

Closed boucadair closed 1 year ago

guyharris commented 1 year ago

I don't see any redundancy; it's just moving the adjectives rather than removing redundant ones.

However, given that the preceding text says "they have been grouped in the following four categories", it's indicated that a list of categories will follow, and the current text doesn't begin each of the next four items with a category indicator, so the replacement text, which does begin each of the next four items with a category indicator, is better.

boucadair commented 1 year ago

I don't see any redundancy; it's just moving the adjectives rather than removing redundant ones.

I agree this may be subtle, but statements such as "OPTIONAL ...MAY" are redundant because both terms means the same thing as per your section 2:


   The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
   "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "**MAY**", and
   "**OPTIONAL**" in this document are to be interpreted as described in
   BCP 14 [RFC2119] [RFC8174] when, and only when, they appear in all
   capitals, as shown here
```.