Re: [netmod] "iana" in yang modules' name/namespace/prefix

[Mahesh Jethanandani <[e-mail]>]

Sent from my iPhone

> On Jul 20, 2018, at 10:40 AM, Juergen Schoenwaelder <[e-mail]> wrote:
> 
>> On Fri, Jul 20, 2018 at 03:45:47PM +0200, Martin Vigoureux wrote:
>> 
>> As part of a recent IESG review (of draft-bfd-yang) a point came up on the
>> use of "iana" in yang modules' name/namespace/prefix.
>> This is typically used in the case where the module refers to an IANA
>> maintained registry. However, the point raised was that the name of the
>> registry operator might not always be IANA, and that using that name might
>> not put modules on the most stable deployment footing under all possible
>> circumstances.
>> 
>> On top of that, as far as I can tell, the use of "iana" is an undocumented
>> convention.
>> 
>> So, I wanted to collect views:
>> on whether a convention should be documented,
>> and, with regards to the point raised in IESG, on whether that keyword
>> should be changed going forward. In that context, what about "reg" (for
>> registry) or "regop" (for registry operator)? Other proposals are welcome.
> 
> iana- has the advantage that everybody knows which registry is meant.
> Using registry- is perhaps more flexible in case IANA registry gets
> renamed but it leaves is much more open where the module is
> maintained. The first part of a module name is supposed to identify an
> organization. draft-ietf-netmod-rfc6087bis-20.txt (RFC editor queue)
> says:
> 
>   It is suggested that a stable prefix be selected representing the
>   entire organization.  All normative YANG modules published by the
>   IETF MUST begin with the prefix "ietf-".  Another standards
>   organization, such as the IEEE, might use the prefix "ieee-" for all
>   YANG modules.
> 
> Concerning documentation, perhaps we could change the above to this:
> 
>   It is suggested that a stable prefix be selected representing the
>   entire organization.  All normative YANG modules published by the
>   IETF MUST begin with the prefix "ietf-".  Another standards
>   organization, such as the IEEE, might use the prefix "ieee-" for all
>   YANG modules. YANG modules maintained by IANA for the IETF SHOULD
>   begin with the prefix "iana-".

+1

I agree that the prefix suggests the organization responsible for maintaining the model, something reg- or registry- does not. Two more examples that already exist are mef- and etsi-. I understand there is the possibility that that prefix changes, but we then pick a new prefix, if we know what it might be. 

> 
> /js
> 
> -- 
> Juergen Schoenwaelder           Jacobs University Bremen gGmbH
> Phone: [phone]         Campus Ring 1 | 28759 Bremen | Germany
> Fax:   [phone]         <https://www.jacobs-university.de/>
> 
> _______________________________________________
> netmod mailing list
> [e-mail]
> https://www.ietf.org/mailman/listinfo/netmod