Re: [CCAMP] [netmod] What to reference when importing an IANA module?

Italo Busi <Italo.Busi@huawei.com> Fri, 13 January 2023 19:16 UTC

Return-Path: <Italo.Busi@huawei.com>
X-Original-To: ccamp@ietfa.amsl.com
Delivered-To: ccamp@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 8CF40C15A727; Fri, 13 Jan 2023 11:16:01 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -6.898
X-Spam-Level:
X-Spam-Status: No, score=-6.898 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, RCVD_IN_DNSWL_HI=-5, RCVD_IN_MSPIKE_H2=-0.001, RCVD_IN_ZEN_BLOCKED_OPENDNS=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_DBL_BLOCKED_OPENDNS=0.001, URIBL_ZEN_BLOCKED_OPENDNS=0.001] autolearn=ham autolearn_force=no
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 4H3UZNo6dTel; Fri, 13 Jan 2023 11:16:00 -0800 (PST)
Received: from frasgout.his.huawei.com (frasgout.his.huawei.com [185.176.79.56]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 344BCC159A24; Fri, 13 Jan 2023 11:16:00 -0800 (PST)
Received: from frapeml500008.china.huawei.com (unknown [172.18.147.206]) by frasgout.his.huawei.com (SkyGuard) with ESMTP id 4NtrjZ5cLtz6J9NZ; Sat, 14 Jan 2023 03:15:46 +0800 (CST)
Received: from frapeml500007.china.huawei.com (7.182.85.172) by frapeml500008.china.huawei.com (7.182.85.71) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2375.34; Fri, 13 Jan 2023 20:15:56 +0100
Received: from frapeml500007.china.huawei.com ([7.182.85.172]) by frapeml500007.china.huawei.com ([7.182.85.172]) with mapi id 15.01.2375.034; Fri, 13 Jan 2023 20:15:56 +0100
From: Italo Busi <Italo.Busi@huawei.com>
To: Benoit Claise <benoit.claise@huawei.com>, tom petch <ietfc@btconnect.com>, "netmod@ietf.org" <netmod@ietf.org>
CC: "ccamp@ietf.org" <ccamp@ietf.org>
Thread-Topic: [netmod] What to reference when importing an IANA module?
Thread-Index: Adkmfno43JPdXxpTR261Pa5dN8ObDAAFgekAAAQP/ez///VuAIABSjCAgAA9f4D//8GiIA==
Date: Fri, 13 Jan 2023 19:15:56 +0000
Message-ID: <464a77e3941140758c77c032bd8caba3@huawei.com>
References: <900fcde63e90473b8424658bc7095818@huawei.com> <ede7a11a-bc66-26a5-f33a-83b15fc61fde@huawei.com> <AM7PR07MB624874275BBD327AEB38C004A0FD9@AM7PR07MB6248.eurprd07.prod.outlook.com> <ab763386-7668-39a7-a080-1bc202eb992e@huawei.com> <AM7PR07MB6248DE5396AC76C0101B233BA0C29@AM7PR07MB6248.eurprd07.prod.outlook.com> <b4dd6eae-7cab-5c87-5e1e-d90a0859b466@huawei.com>
In-Reply-To: <b4dd6eae-7cab-5c87-5e1e-d90a0859b466@huawei.com>
Accept-Language: it-IT, en-US
Content-Language: en-US
X-MS-Has-Attach:
X-MS-TNEF-Correlator:
x-originating-ip: [10.45.154.213]
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: base64
MIME-Version: 1.0
X-CFilter-Loop: Reflected
Archived-At: <https://mailarchive.ietf.org/arch/msg/ccamp/6Cn5dR9VSclHiE-5PeJEEQAFVFM>
Subject: Re: [CCAMP] [netmod] What to reference when importing an IANA module?
X-BeenThere: ccamp@ietf.org
X-Mailman-Version: 2.1.39
Precedence: list
List-Id: Discussion list for the CCAMP working group <ccamp.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/ccamp>, <mailto:ccamp-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/ccamp/>
List-Post: <mailto:ccamp@ietf.org>
List-Help: <mailto:ccamp-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/ccamp>, <mailto:ccamp-request@ietf.org?subject=subscribe>
X-List-Received-Date: Fri, 13 Jan 2023 19:16:01 -0000

I am having the feeling that the discussion is converging about the recommendation to reference the URL instead of the RFC where the initial version of the YANG module has been published

Is my understanding correct?

I agree it would be good to document such a guideline in an update to RFC 8407

I think it would be better to document this in https://datatracker.ietf.org/doc/draft-boucadair-netmod-iana-registries/ as proposed earlier by Med

If we follow this approach, I think it is quite important to also recommend in the guidelines that the following text exists in the YANG module description:

       This version of this YANG module is part of RFC XXXX; see
       the RFC itself for full legal notices.";

Those who the module overview, need to know that it is available in RFC XXXX and the initial revision statement will go deeper and deeper in the module to be easily found

My 2 cents

Italo

> -----Original Message-----
> From: Benoit Claise <benoit.claise@huawei.com>
> Sent: venerdì 13 gennaio 2023 17:26
> To: tom petch <ietfc@btconnect.com>; Italo Busi <Italo.Busi@huawei.com>;
> netmod@ietf.org
> Cc: ccamp@ietf.org
> Subject: Re: [netmod] What to reference when importing an IANA module?
> 
> Hi Tom,
> > Yes I do think that people outside the IETF may be ignorant of the
> > nuances of the way the IETF works and  may not realise that a URL to
> > the IANA website must be used in preference to an RFC.  There is more
> > to YANG modules than extracting the code from somewhere in order to
> > incorporate it into something.  I have even seen RFC reference the
> > obsolete list of possibilities  in the RFC that set up an IANA
> > registry
> If this is the case (And Randy supports this), then we should update RFC 8047.
> 
> Regards, B.