Re: [netmod] I-D Action: draft-ietf-netmod-yang-tree-diagrams-02.txt size

["t.petch" <[e-mail]>]

----- Original Message -----
From: "Mahesh Jethanandani" <[e-mail]>
To: "t.petch" <[e-mail]>
Sent: Thursday, October 26, 2017 6:35 PM

> On Oct 26, 2017, at 9:50 AM, t.petch <[e-mail]> 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" <[e-mail]>
> To: <[e-mail]>
> 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, [e-mail] 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
> [e-mail]
> https://www.ietf.org/mailman/listinfo/netmod

Mahesh Jethanandani
[e-mail]