Re: [sipcore] draft-ietf-sipcore-rejected Terminology

Eric Burger <eburger@standardstrack.com> Thu, 07 March 2019 18:42 UTC

Return-Path: <eburger@standardstrack.com>
X-Original-To: sipcore@ietfa.amsl.com
Delivered-To: sipcore@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 4663412796B for <sipcore@ietfa.amsl.com>; Thu, 7 Mar 2019 10:42:00 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.689
X-Spam-Level:
X-Spam-Status: No, score=-1.689 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_INVALID=0.1, DKIM_SIGNED=0.1, T_SPF_PERMERROR=0.01, URIBL_BLOCKED=0.001] autolearn=no autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=neutral reason="invalid (public key: not available)" header.d=standardstrack.com
Received: from mail.ietf.org ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id H3fEUge0YrOT for <sipcore@ietfa.amsl.com>; Thu, 7 Mar 2019 10:41:58 -0800 (PST)
Received: from biz221.inmotionhosting.com (biz221.inmotionhosting.com [198.46.93.79]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 7080A1277DE for <sipcore@ietf.org>; Thu, 7 Mar 2019 10:41:58 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=standardstrack.com; s=default; h=Message-Id:In-Reply-To:To:References:Date: Subject:Mime-Version:Content-Type:From:Sender:Reply-To:Cc: Content-Transfer-Encoding:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Id: List-Help:List-Unsubscribe:List-Subscribe:List-Post:List-Owner:List-Archive; bh=RvNEsmgyTyuvFAWCQs7eg3CfIsdlZbhXAjW9RC2iZvQ=; b=gaYrx+G7h0ybf45Kyu0Fih6B0 6skz/BG1Mn0XwyWlEBzAEePMoe4c6lyuczj+IUr16L38x3zS+8punrnKw0j+p852tApN/SP/AFkvb aXLGhhkzPrP+4tP/Xch+qPTVsKpGvQuWp0OppJngWQM8c21qT8nb2NE+bv7j7MFkeI+uA=;
Received: from [174.205.7.154] (port=10310 helo=[192.168.43.104]) by biz221.inmotionhosting.com with esmtpsa (TLSv1.2:ECDHE-RSA-AES256-GCM-SHA384:256) (Exim 4.91) (envelope-from <eburger@standardstrack.com>) id 1h1xxk-006ANw-Im for sipcore@ietf.org; Thu, 07 Mar 2019 10:41:57 -0800
From: Eric Burger <eburger@standardstrack.com>
Content-Type: multipart/signed; boundary="Apple-Mail=_2931FE3E-281D-44B2-9F1A-FC869A45670D"; protocol="application/pgp-signature"; micalg="pgp-sha256"
Mime-Version: 1.0 (Mac OS X Mail 12.2 \(3445.102.3\))
Date: Thu, 07 Mar 2019 13:41:46 -0500
References: <6fc6d835-a4c5-1fc1-677b-0ac14c241a6f@nostrum.com> <A77C4C8C-0AF9-4831-A099-C90CE38F72BF@standardstrack.com> <E37B9535-B1B5-4108-81BB-C7815FFAF3BC@brianrosen.net>
To: SIPCORE <sipcore@ietf.org>
In-Reply-To: <E37B9535-B1B5-4108-81BB-C7815FFAF3BC@brianrosen.net>
Message-Id: <B588F2B9-E522-4470-A940-90F69025074E@standardstrack.com>
X-Mailer: Apple Mail (2.3445.102.3)
X-OutGoing-Spam-Status: No, score=-0.2
X-AntiAbuse: This header was added to track abuse, please include it with any abuse report
X-AntiAbuse: Primary Hostname - biz221.inmotionhosting.com
X-AntiAbuse: Original Domain - ietf.org
X-AntiAbuse: Originator/Caller UID/GID - [47 12] / [47 12]
X-AntiAbuse: Sender Address Domain - standardstrack.com
X-Get-Message-Sender-Via: biz221.inmotionhosting.com: authenticated_id: eburger+standardstrack.com/only user confirmed/virtual account not confirmed
X-Authenticated-Sender: biz221.inmotionhosting.com: eburger@standardstrack.com
X-Source:
X-Source-Args:
X-Source-Dir:
Archived-At: <https://mailarchive.ietf.org/arch/msg/sipcore/zmhsaclWFi2mBEu6DLhaq8YdHe0>
Subject: Re: [sipcore] draft-ietf-sipcore-rejected Terminology
X-BeenThere: sipcore@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: SIP Core Working Group <sipcore.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/sipcore>, <mailto:sipcore-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/sipcore/>
List-Post: <mailto:sipcore@ietf.org>
List-Help: <mailto:sipcore-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/sipcore>, <mailto:sipcore-request@ietf.org?subject=subscribe>
X-List-Received-Date: Thu, 07 Mar 2019 18:42:00 -0000

DeMorgan’ theorem for Standards, which I forgot:
x UNLESS y is the same as FOR ALL NOT y, MUST x.
Thanks!

Anyone else?

> On Mar 6, 2019, at 9:28 AM, Brian Rosen <br@brianrosen.net> wrote:
> 
> 5) Cut the second Terminology paragraph.  Reword the instances into If <condition> MUST else SHOULD, but be explicit about the condition.
> 
> 
> 
>> On Mar 5, 2019, at 5:24 PM, Eric Burger <eburger@standardstrack.com> wrote:
>> 
>> Grumble, grumble. That’s my civil disobedience to (1) put the 2119 language into active voice and (2) point out that SHOULD is useless without UNLESS. The various levels of folding on my part would be:
>> 
>> (1) leave it as is
>> 
>> (2) cut the second Terminology paragraph and turn the ‘UNLESS' instances into ‘unless' instances.
>> 
>> (3) cut the second Terminology paragraph and remove the unless clause, turning the SHOULD into the useless SHOULD.
>> 
>> (4) cut the second Terminology paragraph and use the evil passive voice version of the 2119 Terminology paragraph, written by non-writers
>> 
>> How low shall I go? ;-) I’m willing to go all the way if demanded, but my vote would be to keep the language as is. However, it’s only one vote - I’m the editor not author and it’s a work group document, so I will bend to the will of the work group.
>> 
>>> On Mar 5, 2019, at 2:01 PM, A. Jean Mahoney <mahoney@nostrum.com> wrote:
>>> 
>>> Hi Eric and Bhavik,
>>> 
>>> I've been working on the Document Shepherd write-up for the sipcore-rejected draft. The draft's Terminology section and the normative text that uses the term "UNLESS" need updating:
>>> 
>>> 2.  Terminology
>>> 
>>> This document uses the terms "MUST", "MUST NOT", "REQUIRED", "SHALL",
>>> "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and
>>> "OPTIONAL" as described in BCP14 [RFC2119][RFC8174] when, and only
>>> when, they appear in all capitals, as shown here.
>>> 
>>> As a matter of principle, this document uses the term "UNLESS" to
>>> distinguish when a "SHOULD" means "MAY".  Otherwise, the "SHOULD"
>>> means "MUST".  Without UNLESS, SHOULD is meaningless.  A.k.a.
>>> Burger's Law of Protocol Meaningless Terms.
>>> 
>>> 
>>> The following two statements are covered by the "UNLESS" addition:
>>> 
>>> [1]
>>> If an intermediary issues a 608 code, the intermediary SHOULD include
>>> a Call-Info header in the response, UNLESS there are indicators the
>>> calling party will use the contents of the Call-Info header for
>>> malicious purposes (see Section 6).
>>> 
>>> [2]
>>>        As such, the intermediary SHOULD play the announcement,
>>> UNLESS the caveats described in Section 3.5 and Section 6 hold.
>>> 
>>> 
>>> Would you rewrite these statements so that they only use the key words described by [RFC2119][RFC8174]? As the statements are currently constructed, it would be somewhat difficult for an implementer to know what to do since both statements point to largish sections of descriptive text.
>>> 
>>> Thanks!
>>> 
>>> Jean
>>> 
>>> 
>>> 
>>> 
>>> 
>>> 
>>> _______________________________________________
>>> sipcore mailing list
>>> sipcore@ietf.org
>>> https://www.ietf.org/mailman/listinfo/sipcore
>> 
>> _______________________________________________
>> sipcore mailing list
>> sipcore@ietf.org
>> https://www.ietf.org/mailman/listinfo/sipcore
>