[rfc-i] Drafting issue... use of MAY

Barry Leiba barryleiba at computer.org
Wed May 2 16:49:25 PDT 2018


What value does the "MAY" give you there?  Why might I close the
session?  Why might I not?  How do I decide?  What, exactly, is it
that you, the spec writer, are telling me to *do* by using "MAY"
there?

Barry

On Wed, May 2, 2018 at 5:37 PM, Carsten Bormann <cabo at tzi.org> wrote:
> On May 2, 2018, at 21:25, Barry Leiba <barryleiba at computer.org> wrote:
>>
>> AS WRITTEN
>>   When <this happens> the server MAY close the client session."
>>
>> BETTER
>>   When <this happens>, the server is likely to close the client
>>   session, and clients MUST be able to handle that situation.
>
> Not better.  Circumlocution does not help.  The MAY version here is exactly what you should write in this case.
>
> (Of course, for more specific values of “handle that situation”, the MUST version may be appropriate.
> But unsubstantiated judgement calls such as “is likely to” don’t belong into the spec.)
>
> Grüße, Carsten
>



-- 
Barry
--
Barry Leiba  (barryleiba at computer.org)
http://internetmessagingtechnology.org/


More information about the rfc-interest mailing list