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

[tom petch <[e-mail]>]

From: netmod <[e-mail]> on behalf of Benoit Claise <benoit.claise=[e-mail]>
Sent: 19 January 2023 08:31

Hi Med,

On 1/17/2023 2:46 PM, [e-mail]<mailto:[e-mail]> wrote:
If we want to add an IANA link to update RFC 8407, Section 3.9, a couple of remarks:
- It's not clear what "a normative reference with the IANA URL" is.
    Is it https://www.iana.org/assignments/yang-parameters/yang-parameters.xhtml?
    Or is it https://www.iana.org/assignments/yang-parameters/[e-mail]?
    The more precise the later, right?

[Med] None of them. IANA is using dedicated URLs:
* https://www.iana.org/assignments/iana-bgp-l2-encaps/iana-bgp-l2-encaps.xhtml
* https://www.iana.org/assignments/iana-pseudowire-types/iana-pseudowire-types.xhtml
* https://www.iana.org/assignments/iana-bfd-types/iana-bfd-types.xhtml
That would work.
We would need
    - to get the guarantee (from IANA) that those URLs are permanent
    - to clearly mention that THIS URL type is required for IETF YANG modules

<tp>
No chance.  Just as the IETF has reorganised its pages rendering URL in most RFC obsolete, so IANA occasionally re-arranges their website.  Such is life.  Hopefully a tombstone would survive to direct users where to go.

I note that an IANA-maintained module says that the latest version can be obtained from the IANA website but does not give a URL!

Still I think that a URL such as the above which points not to the module itself but to the summary page about the module is the best we can do for an RFC.

Tom Petch

Regards, Benoit

    However, the latter, which is a typical example of IANA maintained YANG module does NOT work, as the revision in the URL changes with any IAN update
- So this leads to have both RFC and IANA, so https://www.iana.org/assignments/yang-parameters/yang-parameters.xhtml + RFC7224 (in the above example)
- Also, we should make more generic for some other SDOs, as IANA is for IETF only.
  And the guidelines are followed by others: BBF, IEEE, etc.