Re: [netmod] rfc 6087bis - stress importance of instance examples

2017-03-08 Thread Ladislav Lhotka
> On 8 Mar 2017, at 18:40, Kent Watsen wrote: > > > >>> I think we should encourage authors to write examples. >> >> +1 And also encourage authors to validate the examples >> using their favorite YANG instance validation tool. > > > Please note this from the latest

Re: [netmod] rfc 6087bis - stress importance of instance examples

2017-03-08 Thread Juergen Schoenwaelder
On Wed, Mar 08, 2017 at 05:40:44PM +, Kent Watsen wrote: > > > >> I think we should encourage authors to write examples. > > > > +1 And also encourage authors to validate the examples > > using their favorite YANG instance validation tool. > > > Please note this from the latest 6087bis

Re: [netmod] rfc 6087bis - stress importance of instance examples

2017-03-08 Thread Kent Watsen
>> I think we should encourage authors to write examples. > > +1 And also encourage authors to validate the examples > using their favorite YANG instance validation tool. Please note this from the latest 6087bis update: 4.12. Module Usage Examples Each specification that defines one

Re: [netmod] rfc 6087bis - stress importance of instance examples

2017-03-07 Thread Martin Bjorklund
Juergen Schoenwaelder wrote: > Hi, > > my experience is that when writing YANG modules it is tremendously > helpful to focus on the instance documents. I find it essential to > write down example snippets of instance documents to see whether they > look

Re: [netmod] rfc 6087bis - stress importance of instance examples

2017-03-03 Thread Phil Shafer
+1. As someone who does internal code review for Juniper changes, having an example is a huge help to the reviewer (me). It also helps to convince the module author (them) that what they are advocating will look horrible. Thanks, Phil Juergen Schoenwaelder writes: >Hi, > >my experience is

[netmod] rfc 6087bis - stress importance of instance examples

2017-03-03 Thread Juergen Schoenwaelder
Hi, my experience is that when writing YANG modules it is tremendously helpful to focus on the instance documents. I find it essential to write down example snippets of instance documents to see whether they look elegant or clumsy. This is often not easy to determine from just reading a YANG