Juergen,
On October 26, 2017 7:43:18 PM Juergen Schoenwaelder
<j.schoenwael...@jacobs-university.de> wrote:
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.
Keep in mind this is guidance, so autos may include a long tree even if the
text says don't. So what do you want them to do if they decide they really
want a many page tree? leave the long tree in the body???
Lou
/js
--
Juergen Schoenwaelder Jacobs University Bremen gGmbH
Phone: +49 421 200 3587 Campus Ring 1 | 28759 Bremen | Germany
Fax: +49 421 200 3103 <http://www.jacobs-university.de/>
_______________________________________________
netmod mailing list
netmod@ietf.org
https://www.ietf.org/mailman/listinfo/netmod
