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

[Juergen Schoenwaelder <[e-mail]>]

On Thu, Oct 26, 2017 at 07:03:11PM -0400, Lou Berger wrote:
> 
>    As tree diagrams are intended to provide a simplified view of a
>    module, diagrams longer than a page should generally be avoided.  If
>    the complete tree diagram for a module becomes too long, the diagram
>    can be split into several smaller diagrams.  For example, it might be
>    possible to have one diagram with the data node and another with all
>    notifications.  If the data nodes tree is too long, it is also
>    possible to split the diagram into smaller diagrams for different
>    subtrees.  When long diagrams are included in a document, authors
>    should consider whether to include the long diagram in the main body
>    of the document or in an appendix.
> 
> 
> again, please suggest improvements.
>

Remove the last sentence. Moving lengthy diagrams to an appendix does
not help the reader.

/js

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