Consistency of keywords

[Nat Sakimura]

The spec currently mixes MUST/must/SHALL/shall.

It needs to be consistent.

Also, keywords definition should be there. Draft -05 removed RFC 2119 keywords from scope & requirements.

‌

[Hodari McClain]

for reference: https://datatracker.ietf.org/doc/html/rfc2119

[Daniel Fett]

ISO keywords are explained here: https://www.iso.org/foreword-supplementary-information.html

[Mark Haine]

I had a chat with Nat, my notes form that WRT this issue are that when using RFC 2119 is is not good to use normative words in a way that does not have a normative meaning - so re-phrase the sentenses with lowercase ‘normative’ words to use other words. This should be done regardless of the decision about ISO style -vs- RFC 2119 style because ISO style does not use capitalisation as it cannot be translated.

[Mark Haine]

The word MAY/may needs to be looked at as well. two questions:

if “may” then can we re-word to some other term?

if “MAY” then is it really needed? In ISO “may” grants permission and “can” indicates an option.

[Mark Haine]

Resolved by PR #194