Re: [Netconf] We NEED RESPONSES: WG Last Call ended for:draft-ietf-netconf-4741bis-04.txt

[Juergen Schoenwaelder <[e-mail]>]

On Wed, Oct 06, 2010 at 03:33:59PM +0200, Ersue, Mehmet (NSN - DE/Munich) wrote:
> > On Wed, Oct 06, 2010 at 02:24:23PM +0200, Ersue, Mehmet (NSN -
> > DE/Munich) wrote:
> > > > > Section 12.2. Informative References
> > > > >
> > > > > Add draft-ietf-netmod-yang-usage-11 as informative reference.
> > > >
> > > > Why?  That document is intended for YANG module writers.
> > >
> > > Appendix C includes a normative YANG module and IANA considerations
> > > include namespace registration, etc., which follow the guidelines
> > > in draft-ietf-netmod-yang-usage.
> > > I think people who read the YANG module in 4741bis should be also
> > > pointed to the guidelines document.
> > 
> > Why? The guidelines are for module writers / reviewers not module
> > readers. You want to have them cited in each and every module we
> > publish? We do not do this for MIB modules.
> 
> It is actually the same reason why we have the informative 
> reference on:
> 
> [13]  Hollenbeck, S., Rose, M., and L. Masinter, "Guidelines for the
>       Use of Extensible Markup Language (XML) within IETF Protocols",
>       BCP 70, RFC 3470, January 2003.

Since the document in question defines a protocol that carries XML,
having this reference may seem different from requiring a reference to
the YANG guidelines how to write a YANG proper module in every YANG
module. At least in the SMIv2 space, we managed to live without it.

But then, if you feel strongly about this, lets just add it instead of
debating this long.

Lets hope the guidelines document gives the guideline that the
guidelines document select-one-of(must|MUST|should|SHOULD) be
cited. ;-)

/js

-- 
Juergen Schoenwaelder           Jacobs University Bremen gGmbH
Phone: [phone]         Campus Ring 1, 28759 Bremen, Germany
Fax:   [phone]         <http://www.jacobs-university.de/>