> But a 40 page tree diagram isn't very useful anyway, imo. If I want > the full tree diagram I can run a tool to generate it. Tree diagrams > are best used in combination with explanatory text to explain certain > aspects of the module design. Perhaps section 3.4 in RFC 8407 should be > updated to explain this.
Agreed. The netconf-client-server and restconf-client-server drafts had “full” diagrams that were many pages long. Fixed by: 1) Introducing each grouping individually (I wrote a script to extract a particular grouping tree diagram) 2) Convert all diagrams to NOT expand groupings. I.e., it prints just the grouping’s name. 3) The text for each grouping includes the hyperlink to the other sections where the each used-grouping is defined. 4) Remove from the document the mostly-useless super-long diagram. K. _______________________________________________ netmod mailing list [email protected] https://www.ietf.org/mailman/listinfo/netmod
