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

2023-01-19 Thread Benoit Claise

Hi Med,

On 1/17/2023 2:46 PM, mohamed.boucad...@orange.com 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/iana-if-t...@2022-08-24.yang?

    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


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.

___
netmod mailing list
netmod@ietf.org
https://www.ietf.org/mailman/listinfo/netmod


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

2023-01-19 Thread tom petch
From: netmod  on behalf of Benoit Claise 

Sent: 19 January 2023 08:31

Hi Med,

On 1/17/2023 2:46 PM, 
mohamed.boucad...@orange.com 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/iana-if-t...@2022-08-24.yang?
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


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.


___
netmod mailing list
netmod@ietf.org
https://www.ietf.org/mailman/listinfo/netmod