----- Original Message ----- From: "Mahesh Jethanandani" <mjethanand...@gmail.com> To: "t.petch" <ie...@btconnect.com> Sent: Thursday, October 26, 2017 6:35 PM
> On Oct 26, 2017, at 9:50 AM, t.petch <ie...@btconnect.com> wrote: > > Lou > > I like the advice that diagrams should be one page long but wonder how > to apply that to those I see in routing WGs. I have just been looking > at > > draft-ietf-teas-yang-te-topo-12 > > where the diagram is 36 pages long - which may be one of the larger ones > but by no means exceptional - and I think the diagram is more or less > useless as a result. But what practical advice can we give them? How about using the depth of the —tree-depth option to generate smaller trees that may not give the whole tree, but at least give you a nice overview? Follow that with smaller chunks using the —tree-path for each section of the tree. <tp> Yes! That is what I do manually when I really really want to understand and refer to a module - but it is time consuming and tedious. I look to have a top level of less than a page and lower levels which may be bigger. I think that this also interacts with groupings. If a tree diagram with groupings expanded is 6 pages and one without the expansion is 2 pages plus one for the grouping, then I would prefer the latter. YMMV but I think that there is a guideline in there somewhere. Tom Petch > > I append the diagram below > > Tom Petch > > > start of diagram > ================================================== <snip>. > +--ro altitude? int64 > +--ro latitude? geographic-coordinate-degree > +--ro longitude? geographic-coordinate-degree > > > > ===================================== > end of diagram > > ----- Original Message ----- > From: "Lou Berger" <lber...@labn.net> > To: <netmod@ietf.org> > Sent: Wednesday, October 25, 2017 2:13 PM > Subject: Re: [netmod] I-D Action: > draft-ietf-netmod-yang-tree-diagrams-02.txt > > >> Hi, >> >> This version addresses all known / open issues in the draft known to >> the authors. >> >> The changes are as follows: >> - Added groupings and yang-data descriptions >> - Added Comments, Long Diagrams and Security Considerations sections >> - Clarified representation of schema mount points and representation > of >> modules exposed using schema mount. >> - Miscellaneous editorial changes >> >> Lou (for draft authors) >> >> On 10/25/2017 8:49 AM, internet-dra...@ietf.org wrote: >>> A New Internet-Draft is available from the on-line Internet-Drafts > directories. >>> This draft is a work item of the Network Modeling WG of the IETF. >>> >>> Title : YANG Tree Diagrams >>> Authors : Martin Bjorklund >>> Lou Berger >>> Filename : draft-ietf-netmod-yang-tree-diagrams-02.txt >>> Pages : 11 >>> Date : 2017-10-25 >>> > > _______________________________________________ > netmod mailing list > netmod@ietf.org > https://www.ietf.org/mailman/listinfo/netmod Mahesh Jethanandani mjethanand...@gmail.com _______________________________________________ netmod mailing list netmod@ietf.org https://www.ietf.org/mailman/listinfo/netmod