Re: [Netconf] draft-ietf-netconf-monitoring-09 last call comments from js

["Romascanu, Dan (Dan)" <dromasca at avaya.com>]

> -----Original Message-----
> > 
> > Amen.  Can we go further and encourage the YANG module to _be_ the 
> > full RFC, so extracting the module gives the full normative text of 
> > the RFC inside the module?  So the RFC is some introductory text, 
> > followed by the YANG module with all the normative text as 
> comments or 
> > descriptions inside that file.  Extracting the module gives you 
> > everything and there's not duplicate text to get out of 
> sync or to add 
> > confusion.
> 
> This is pretty much what we have been doing in SMIv2 land.
> 
> /js
> 

Yes. This may be straighten up in the guideline document -
http://www.ietf.org/id/draft-ietf-netmod-yang-usage-02.txt . 

While completing avoiding duplication is not always possible it should
be made clear that the YANG module is the normative text. Useful
information may be present in the RFC (like security considerations,
relations with other modules, application examples, etc.) but the
information in the module itself should be complete enough to allow for
implementation.

Dan