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

Randy Presuhn <randy_presuhn@alumni.stanford.edu> Fri, 13 January 2023 20:22 UTC

Return-Path: <randy_presuhn@alumni.stanford.edu>
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 702B6C16FE21 for <ccamp@ietfa.amsl.com>; Fri, 13 Jan 2023 12:22:15 -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, NICE_REPLY_A=-0.001, RCVD_IN_DNSWL_HI=-5, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_ZEN_BLOCKED_OPENDNS=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-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 xnCvhDz_LeKp for <ccamp@ietfa.amsl.com>; Fri, 13 Jan 2023 12:22:13 -0800 (PST)
Received: from mail-pl1-f181.google.com (mail-pl1-f181.google.com [209.85.214.181]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id A3A8BC16ECF9 for <ccamp@ietf.org>; Fri, 13 Jan 2023 12:22:13 -0800 (PST)
Received: by mail-pl1-f181.google.com with SMTP id d3so24522060plr.10 for <ccamp@ietf.org>; Fri, 13 Jan 2023 12:22:13 -0800 (PST)
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:in-reply-to:from:references:to :content-language:subject:user-agent:mime-version:date:message-id :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=Wk3b/sHa0dztD5/vlr6AxXcm7j5Wendy0DNxistYltU=; b=siLOpzjHO4peyPGipbD66TU/6QBuM/IdKhnXNkjDKJ9uQmROZrSlG7BfjvtiV8V+b4 OcfXn4ql4jJxQ95B66b4nBYgHjtVn0MDQvJfqS/3MvIbZ2B3N9qXWHFw9GV+NIwp05P/ 0N19PxAJUI0CXHhAOTRxvyirhI5liRc4R6ll4WfeF4ejEy2NNp3JaBY9ORqW8RkV3BXK JImq+OzDFWr6eESVPwXVY7YsPoyadqeVrfLI2kXqRhpqQHLb8XXrfdRyz7CTL/30c1ud +kyoUUMFdDrtIH34cDWqKY5p0iKyaxQDDqPN8lT4WfRzeyz+hWZKv6PRUFOwK3W14SJl Kb9w==
X-Gm-Message-State: AFqh2kqYwi4EwRASmVeTllqTFuMotfJSNDQTeszKLi1bk5QsZADEKV0s EkFzXp6CgTn1VV/Qdy7WDHsj4seSZt2aVlct
X-Google-Smtp-Source: AMrXdXvQzZe4nKK669YXzh8CZG8pbeww/81XcLtGhC5PNU4CX2XGe+scpKfvXcxaEhKpLxxs/xaWrA==
X-Received: by 2002:a17:90a:5b05:b0:225:d190:f16c with SMTP id o5-20020a17090a5b0500b00225d190f16cmr71021225pji.21.1673641333010; Fri, 13 Jan 2023 12:22:13 -0800 (PST)
Received: from ?IPV6:2601:646:9300:b1e:65ab:49b1:a611:fad? ([2601:646:9300:b1e:65ab:49b1:a611:fad]) by smtp.gmail.com with ESMTPSA id c64-20020a17090a494600b0022918905340sm2070711pjh.36.2023.01.13.12.22.12 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Fri, 13 Jan 2023 12:22:12 -0800 (PST)
Message-ID: <072be8fa-3801-1236-752a-e44df9347d18@alumni.stanford.edu>
Date: Fri, 13 Jan 2023 12:22:10 -0800
MIME-Version: 1.0
User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:102.0) Gecko/20100101 Thunderbird/102.6.1
Content-Language: en-US
To: "ccamp@ietf.org" <ccamp@ietf.org>, "netmod@ietf.org" <netmod@ietf.org>
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> <01000185ac5c8328-452eee8e-b8d8-4ef0-955a-e2ead0c557b2-000000@email.amazonses.com>
From: Randy Presuhn <randy_presuhn@alumni.stanford.edu>
In-Reply-To: <01000185ac5c8328-452eee8e-b8d8-4ef0-955a-e2ead0c557b2-000000@email.amazonses.com>
Content-Type: text/plain; charset="UTF-8"; format="flowed"
Content-Transfer-Encoding: 7bit
Archived-At: <https://mailarchive.ietf.org/arch/msg/ccamp/NvFtOY9uxw2oPvNNMeEmWz9Lm0c>
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 20:22:15 -0000

Hi -

On 2023-01-13 10:20 AM, Kent Watsen wrote:
> 
> 
>> On Jan 13, 2023, at 11:25 AM, Benoit Claise <benoit.claise=40huawei.com@dmarc.ietf.org> wrote:
>>
>> 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.

Benoit's reference to RFC 8047 had me puzzled until I saw Kent's
response regarding RFC 8407.  :-)

> Agreed - as a hold for document update?
> 
> Currently RFC 8407, Section 3.9 says:
> 
>     For every import or include statement that appears in a module
>     contained in the specification that identifies a module in a separate
>     document, a corresponding normative reference to that document MUST
>     appear in the Normative References section.  The reference MUST
>     correspond to the specific module version actually used within the
>     specification.

I agree with Kent's "hold for document update" assessment.  The
difficultly with the existing text is that it correctly reflects
the concerns that were at the forefront when it was written -
e.g. making it as easy as possible for developers to get the
necessary context for implementing a module, but, as far as
I can recall, the group hadn't thought as deeply about
registries spun off from an initial document.

> Want to take a swing at it?

Not me.  :-)  There are competing requirements, and the "best" answer
will very much depend on each situation.  I think the *spirit* of
the RFC 8407 Section 3.9 is  "point to whatever resource will be most
enlightening to the developer / user."  But the letter of the law is
"point to whatever is needed to generate a tree of normative
reference dependencies" - that is, use what will be most helpful
to the people writing the standards.  There's a point to both kinds of
pointers.

When in doubt, my preference is to go whichever way will make it
harder for implementations to get it wrong.

Randy