Lines too long in YANG tree diagrams

Italo Busi <Italo.Busi=40huawei.com-Tr9gZwTxerDR74oF6e/[email protected]> Wed, 5 Jul 2023 21:58:46 +0000
Newsgroups gmane.ietf.netmod,gmane.ietf.ccamp
Message-ID <[email protected]>
RFC8340 suggests to use the "--tree-line-length 69" option to produce YANG tree diagrams to be included into an Internet-Draft or RFC.

Although this option works well in many cases, there are few cases where pyang produces YANG tree diagram with lines too long even with the "--tree-line-length 69" option and in this case it is not fully clear what could be done when including those  YANG tree diagram into Internet-Drafts or RFCs

Section 5.2 of RFC8792 says:

It is RECOMMENDED that authors do as much as possible within the selected format to avoid long lines.

My interpretation of the RECOMMENDED key word and of "as much as possible" is that we MUST always use the "--tree-line-length 69" option to generate the YANG tree diagrams to be included into Internet-Drafts or RFCs and that we MAY use RFC8792 tool to fold the YANG tree diagrams when they contain lines too long

Is my interpretation correct?

Thanks, Italo