Re: [yang-doctors] [IANA #1173669] questions about IANA-maintained YANG modules

Hi Amanda,

> On Jul 6, 2020, at 11:41 AM, Amanda Baber via RT <iana-issues-comment@iana.org> wrote:
> 
> Dear YANG Doctors,
> 
> I'm afraid we have more questions about references in revision comments.
> 
> We sometimes make registrations in the Address Family Numbers, SAFI Values, and ifType registries for individual requesters, non-IETF standards documents, and I-Ds that haven't been sent to IETF Last Call yet. When we add entries like this to a YANG module, do we need to include a reference in the revision comment?

I, as a common practice do include a reference in the revision statement. That reference is usually to most important document that describes the module in question.

> 
> These are some examples of entries in the "Reference" field for recent registrations:
> 
> Nischal Sheth
> draft-kaliraj-idr-bgp-classful-transport-planes-00
> IEEE 1906.1-2015
> 
> Another question: we initially missed the requirement to include references in revision statements. Can we add missing references to existing revision statements and then add a single blanket revision statement (with no reference) noting that we added the missing references?
> 
> If we introduce a typo into an IANA-maintained YANG module, can we make the correction without adding a revision statement and changing the date in the filename?

In my mind, a module revision statement needs to be bumped if there is a significant change in the module. A typo or adding a missing reference does not rise to the level of a significant change in my mind.

Thanks.

> 
> thanks,
> Amanda
> 
> _______________________________________________
> yang-doctors mailing list
> yang-doctors@ietf.org
> https://www.ietf.org/mailman/listinfo/yang-doctors

Mahesh Jethanandani
mjethanandani@gmail.com