Re: [netmod] Rfc8407 - what does this text mean?

Kent Watsen <kent+ietf@watsen.net> Mon, 19 February 2024 14:54 UTC

Return-Path: <0100018dc1dc6029-466c9a12-e954-42e7-ab25-9d999aeeb360-000000@amazonses.watsen.net>
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 A509EC14F71B for <netmod@ietfa.amsl.com>; Mon, 19 Feb 2024 06:54:26 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.902
X-Spam-Level:
X-Spam-Status: No, score=-1.902 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_BLOCKED=0.001, RCVD_IN_MSPIKE_H5=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_ZEN_BLOCKED_OPENDNS=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01, URIBL_BLOCKED=0.001, URIBL_DBL_BLOCKED_OPENDNS=0.001, URIBL_ZEN_BLOCKED_OPENDNS=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=amazonses.com
Received: from mail.ietf.org ([50.223.129.194]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id ZFlIWE4IeYaq for <netmod@ietfa.amsl.com>; Mon, 19 Feb 2024 06:54:23 -0800 (PST)
Received: from a48-90.smtp-out.amazonses.com (a48-90.smtp-out.amazonses.com [54.240.48.90]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-SHA256 (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id E727FC14F71D for <netmod@ietf.org>; Mon, 19 Feb 2024 06:54:22 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/simple; s=224i4yxa5dv7c2xz3womw6peuasteono; d=amazonses.com; t=1708354461; h=From:Message-Id:Content-Type:Mime-Version:Subject:Date:In-Reply-To:Cc:To:References:Feedback-ID; bh=Zs+bCfMBrVMJ/8jPWjZMHVuAGmWttcLFnLJzYYSaYns=; b=g9ilT6AaOE24vpYUyjfMiUZEsSDSGsEm5Ff0sy0F95EnmRIQPBM2ZKKMkEnxsPTb m/1bhi49F3ntbRUDCkOlFM/LZfca4FVGJzcqwRbCoOETz1CxPSsOuqB9TTQ9Gb07nji juMUoRomlBuns/pcKk8KmTXuF9dTn5TdJnzEq0nw=
From: Kent Watsen <kent+ietf@watsen.net>
Message-ID: <0100018dc1dc6029-466c9a12-e954-42e7-ab25-9d999aeeb360-000000@email.amazonses.com>
Content-Type: multipart/alternative; boundary="Apple-Mail=_6553BDCA-415C-40DA-9808-6ACBCBDC608C"
Mime-Version: 1.0 (Mac OS X Mail 16.0 \(3731.600.7\))
Date: Mon, 19 Feb 2024 14:54:21 +0000
In-Reply-To: <DU2PR02MB10160E3ED307A860258A8E28588512@DU2PR02MB10160.eurprd02.prod.outlook.com>
Cc: Andy Bierman <andy@yumaworks.com>, "netmod@ietf.org" <netmod@ietf.org>
To: Mohamed Boucadair <mohamed.boucadair@orange.com>
References: <0100018db387ce0a-80850b96-bf6b-4978-afde-27d38f36bcd8-000000@email.amazonses.com> <CABCOCHQpvAwYbPyXqOW3P=4GWhCdWWmmKaQh4eubetSn0VMyLQ@mail.gmail.com> <0100018db3b387be-74bd44a5-35a1-463f-b787-84a2177c1800-000000@email.amazonses.com> <DU2PR02MB10160E3ED307A860258A8E28588512@DU2PR02MB10160.eurprd02.prod.outlook.com>
X-Mailer: Apple Mail (2.3731.600.7)
Feedback-ID: 1.us-east-1.DKmIRZFhhsBhtmFMNikgwZUWVrODEw9qVcPhqJEI2DA=:AmazonSES
X-SES-Outgoing: 2024.02.19-54.240.48.90
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/3T6i9zYe1Fg-XQXXoP_cOyc_nJI>
Subject: Re: [netmod] Rfc8407 - what does this text mean?
X-BeenThere: netmod@ietf.org
X-Mailman-Version: 2.1.39
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: Mon, 19 Feb 2024 14:54:26 -0000

Hi Med,

> On Feb 19, 2024, at 3:29 AM, mohamed.boucadair@orange.com wrote:
> 
> Hi Kent, all,
>  
> I also think that highlighting the exceptions + motivate them makes sense here. A PR to fix that can be seen at [1].

Thank you.  

I hope folks express objections now, before WGLC, as an expeditious resolution helps me close off an IESG review comment in NETCONF.


> FWIW, the OLD text was added draft-ietf-netmod-rfc6087bis-17 as per a comment in the AD review [2].

That’s a great find!


> Cheers,
> Med

K.


>  
> [1] https://author-tools.ietf.org/api/iddiff?url_1=https://boucadair.github.io/rfc8407bis/draft-ietf-netmod-rfc8407bis.txt&url_2=https://boucadair.github.io/rfc8407bis/nmda-exceptions/draft-ietf-netmod-rfc8407bis.txt
>  
> [2] https://mailarchive.ietf.org/arch/msg/netmod/B4TUQZf7jud5wqrBwzEqEND6-rw/
>  
>  
> De : netmod <netmod-bounces@ietf.org <mailto:netmod-bounces@ietf.org>> De la part de Kent Watsen
> Envoyé : vendredi 16 février 2024 21:55
> À : Andy Bierman <andy@yumaworks.com <mailto:andy@yumaworks.com>>
> Cc : netmod@ietf.org <mailto:netmod@ietf.org>
> Objet : Re: [netmod] Rfc8407 - what does this text mean?
>  
> Hi Andy,
>  
> Thanks for the speedy reply.
>  
> This guidance seems inverted, at least within the IETF (where SHOULDs are interpreted as MUSTs), and likely outside the IETF also, assuming rfc8407 is read.  See the first paragraph of https://datatracker.ietf.org/doc/html/rfc8407#section-4.23.3 
>  
> I doubt any module would get past the IETF-publication process now if it defined a non-NMDA compliant structure (i.e., CF nodes that provide the opstate value for CT nodes), unless it was a “temporary non-NMDA module” (https://datatracker.ietf.org/doc/html/rfc8407#section-4.23.3.1).
>  
> Since this, for awhile now, is the normal thing to do, the text highlighted in my OP seems to have little to no value.  That said, an “inverted” statement would have some value, that is, to explicitly highlight if the document defines any “temporary non-NMDA modules”.  This would be akin to highlighting when a document defines any IANA-maintained modules.
> 
> 
> I am proposing to update the text in rfc8407bis accordingly (to invert the guidance).  Thoughts?
> 
> 
> If there is agreement to update this text accordingly, I will delete the "Adherence to the NMDA” section in all my drafts, since none of them define a “temporary non-NMDA module”.
>  
> PS: top-posting for simplicity
>  
> K.
>  
>  
> 
> 
> On Feb 16, 2024, at 3:25 PM, Andy Bierman <andy@yumaworks.com <mailto:andy@yumaworks.com>> wrote:
>  
>  
>  
> On Fri, Feb 16, 2024 at 12:07 PM Kent Watsen <kent+ietf@watsen.net <mailto:kent%2Bietf@watsen.net>> wrote:
> NETMOD,
>  
> An IESG member reviewing one of my drafts flagged a section I had written to satisfy this text from https://datatracker.ietf.org/doc/html/rfc8407#section-3.5:
>  
>        If the document contains a YANG module(s) that is compliant with NMDA
>        [RFC8342], then the Introduction section should mention this fact.
>  
>        Example:
>  
>          The YANG data model in this document conforms to the Network
>          Management Datastore Architecture defined in  RFC 8342.
>  
>  
> What does "compliant with NMDA” actually mean?   Are not all modules “compliant”, even if they unnecessarily define some opstate nodes?
>  
>  
> I do not recall the discussions that led to that text.
>  
> Does this sentence actually point to if the document publishes any so called “-state” modules, defined only to support legacy “non-NMDA” servers?
>  
>  
> I think the state modules are optional, so it is still unclear what NMDA conformance means for a YANG module. 
>  
>  
> Does it make sense to clarify this text, since rfc8407bis is an open WG document at the moment?
>  
> maybe it means to follow all the guidelines in 4.23.3
> https://datatracker.ietf.org/doc/html/rfc8407#section-4.23.3
>  
> maybe remove this other text you cite.
>  
>  
>  
> Thanks,
> Kent
>  
>  
> Andy
>  
> _______________________________________________
> netmod mailing list
> netmod@ietf.org <mailto:netmod@ietf.org>
> https://www.ietf.org/mailman/listinfo/netmod
>  
> ____________________________________________________________________________________________________________
> Ce message et ses pieces jointes peuvent contenir des informations confidentielles ou privilegiees et ne doivent donc
> pas etre diffuses, exploites ou copies sans autorisation. Si vous avez recu ce message par erreur, veuillez le signaler
> a l'expediteur et le detruire ainsi que les pieces jointes. Les messages electroniques etant susceptibles d'alteration,
> Orange decline toute responsabilite si ce message a ete altere, deforme ou falsifie. Merci.
> 
> This message and its attachments may contain confidential or privileged information that may be protected by law;
> they should not be distributed, used or copied without authorisation.
> If you have received this email in error, please notify the sender and delete this message and its attachments.
> As emails may be altered, Orange is not liable for messages that have been modified, changed or falsified.
> Thank you.