[netmod] RFC 2119 language [was Re: WG Last Call: draft-ietf-netmod-revised-datastores-04 updates]

Robert Wilton <rwilton@cisco.com> Wed, 27 September 2017 16:28 UTC

Return-Path: <rwilton@cisco.com>
X-Original-To: netmod@ietfa.amsl.com
Delivered-To: netmod@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id CBD0E134E2A; Wed, 27 Sep 2017 09:28:22 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -14.5
X-Spam-Level:
X-Spam-Status: No, score=-14.5 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_HI=-5, SPF_PASS=-0.001, USER_IN_DEF_DKIM_WL=-7.5] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=cisco.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 0smGE3xEfAQT; Wed, 27 Sep 2017 09:28:20 -0700 (PDT)
Received: from aer-iport-4.cisco.com (aer-iport-4.cisco.com [173.38.203.54]) (using TLSv1.2 with cipher DHE-RSA-SEED-SHA (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 477FF134E28; Wed, 27 Sep 2017 09:28:19 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=cisco.com; i=@cisco.com; l=6986; q=dns/txt; s=iport; t=1506529699; x=1507739299; h=subject:to:references:from:message-id:date:mime-version: in-reply-to; bh=bBhv2nES5lYdpyYTmqGqZ4MebLQ9GtcxZmPoAa094lo=; b=TUr4umjRPC3VqQJyICSMbbPoqVztqzOxL6zursRksdAz7dRStBJaHBYF XpoTaxtb6gZuZdHVfZIsGbPGHGoYWUkzNgid2QKZmRbNbE19KQVp2jGBC FUXUqE6S8PmCT+h7JUPjmujG+nDtMIo3xhtk3cVXWcOdjaFX2TcIUZidy w=;
X-IronPort-Anti-Spam-Filtered: true
X-IronPort-Anti-Spam-Result: A0DOAQBF0MtZ/xbLJq1aAxkBAQEBAQEBAQEBAQcBAQEBAYRAbieDeIsTkGCQbYdQCiODOoFeAoUfFAECAQEBAQEBAWsohRkBBSNkAgkSAgYnAwICGysDDgYBDAYCAQGKLRCKV51mgicnil4BAQEBAQEBAQEBAQEBAQEBAQEBAQEdBYMmg1OBaiuEOoNoJoJMgmAFmE+IVIdejQGCE4lIhyuKDYNjh1mBOTYhgQ4yIQgdFR+FCzkMEBmBTz82ii8BAQE
X-IronPort-AV: E=Sophos;i="5.42,445,1500940800"; d="scan'208,217";a="657867804"
Received: from aer-iport-nat.cisco.com (HELO aer-core-3.cisco.com) ([173.38.203.22]) by aer-iport-4.cisco.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 27 Sep 2017 16:28:15 +0000
Received: from [10.63.23.161] (dhcp-ensft1-uk-vla370-10-63-23-161.cisco.com [10.63.23.161]) by aer-core-3.cisco.com (8.14.5/8.14.5) with ESMTP id v8RGSE0I020031; Wed, 27 Sep 2017 16:28:15 GMT
To: netmod WG <netmod@ietf.org>, NetMod WG Chairs <netmod-chairs@ietf.org>, draft-ietf-netmod-revised-datastores@ietf.org
References: <511deba5-34ca-dde2-6637-ceaf4c4af125@labn.net> <022001d32e14$8d5d4540$4001a8c0@gateway.2wire.net> <20170915123443.kvagu7dut7oaqoo2@elstar.local> <CABCOCHQcSUSUZMvzVGyaXObHadZqksKge89_6YcH9PCbxMCG=g@mail.gmail.com> <20170916072403.xp37556z6g7b42gr@elstar.local> <CABCOCHT8CMCAnqf6Oe1bKMzQ-B_0GjrQiQ8YXgQJvCo-NBOBBA@mail.gmail.com>
From: Robert Wilton <rwilton@cisco.com>
Message-ID: <07b5a5df-794e-2ba8-6cad-abfcfadfc4cc@cisco.com>
Date: Wed, 27 Sep 2017 17:28:14 +0100
User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:52.0) Gecko/20100101 Thunderbird/52.3.0
MIME-Version: 1.0
In-Reply-To: <CABCOCHT8CMCAnqf6Oe1bKMzQ-B_0GjrQiQ8YXgQJvCo-NBOBBA@mail.gmail.com>
Content-Type: multipart/alternative; boundary="------------B29F64369E06B6D5412D01D7"
Content-Language: en-US
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/zpzc56sMaDMSOlNCfj3r8zak454>
Subject: [netmod] RFC 2119 language [was Re: WG Last Call: draft-ietf-netmod-revised-datastores-04 updates]
X-BeenThere: netmod@ietf.org
X-Mailman-Version: 2.1.22
Precedence: list
List-Id: NETMOD WG list <netmod.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/netmod>, <mailto:netmod-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/netmod/>
List-Post: <mailto:netmod@ietf.org>
List-Help: <mailto:netmod-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/netmod>, <mailto:netmod-request@ietf.org?subject=subscribe>
X-List-Received-Date: Wed, 27 Sep 2017 16:28:23 -0000

The authors discussed this, and we will close this issue 
(https://github.com/netmod-wg/datastore-dt/issues/14 - title: Does the 
NMDA architecture need to use RFC 2119 language?) by adding RFC 2119 
text to the document, which will probably be best illustrated with an 
updated draft revision.

For the record, the majority of the authors had the view that RFC 2119 
language does not particularly aid readability in this architecture 
document.

Thanks,
Rob


On 16/09/2017 10:56, Andy Bierman wrote:
>
>
> On Sat, Sep 16, 2017 at 12:24 AM, Juergen Schoenwaelder 
> <j.schoenwaelder@jacobs-university.de 
> <mailto:j.schoenwaelder@jacobs-university.de>> wrote:
>
>     On Fri, Sep 15, 2017 at 02:07:58PM -0700, Andy Bierman wrote:
>     > Hi,
>     >
>     > I strongly agree with Tom that the current draft is an update to
>     RFC 7950.
>     > I also strongly disagree with the decision to omit RFC 2119 in a
>     standards
>     > track document. IMO RFC 2119 terms need to be used in normative
>     text,
>     > especially when dealing with XPath and YANG compiler behavior.
>     >
>
>     RFC 8174:
>
>        o  These words can be used as defined here, but using them is not
>           required.  Specifically, normative text does not require the use
>           of these key words.  They are used for clarity and consistency
>           when that is what's wanted, but a lot of normative text does not
>           use them and is still normative.
>
>
> So what?
> Existing YANG specifications use RFC 2119 terms.
> This draft uses those terms, just with lower-case.
> Either way, the new YANG rules seem half-baked and not ready
> for standardization.
>
>     /js
>
>
> Andy
>
>     --
>     Juergen Schoenwaelder           Jacobs University Bremen gGmbH
>     Phone: +49 421 200 3587         Campus Ring 1 | 28759 Bremen | Germany
>     Fax:   +49 421 200 3103         <http://www.jacobs-university.de/
>     <http://www.jacobs-university.de/>>
>
>