As per RFC2119, SHALL and IS REQUIRED are synonyms for MUST, an absolute requirement of the specification. We had a misunderstanding in our team about SHALL, as it is easily confused with SHOULD where valid reasons may exist to deviate.
This .edition change removes this ambiguity by replacing the synonyms with a clear MUST.
I'm a bit reluctant to change the text for this reason alone. The RFC 2119 language is widespread and how the words are to be interpreted is very clear and widely known and recognized in the industry.
As per RFC2119,
SHALL
andIS REQUIRED
are synonyms forMUST
, an absolute requirement of the specification. We had a misunderstanding in our team aboutSHALL
, as it is easily confused withSHOULD
where valid reasons may exist to deviate. This .edition change removes this ambiguity by replacing the synonyms with a clearMUST
.