I believe there is nothing to change, RFC 8407 got it straight: 3.4. Tree Diagrams
YANG tree diagrams provide a concise representation of a YANG module and SHOULD be included to help readers understand YANG module structure. Guidelines on tree diagrams can be found in Section 3 of [RFC8340]. It is somewhat pointless to talk about pages on modern RFC formats that have no pages or varying page sizes and I think it is best to leave the guidance on the use of tree diagrams to RFC8340. (There is also no need to add another SHOULD that RFC 8340 should be consulted - are we approaching the point where every sentence has to have a capitalized verb?) I vote for no change of the RFC 8407 text here. /js On Mon, Dec 02, 2024 at 06:12:08PM -0500, Lou Berger wrote: > Med, > > Thanks for the update, you now have: > > 3.4. Tree Diagrams > > YANG tree diagrams provide a concise representation of a YANG module > and SHOULD be included to help readers understand YANG module > structure. Guidelines on tree diagrams can be found in Section 3 of > [RFC8340]. Tree diagrams longer than one page SHOULD be included in > an appendix, i.e., not in the main body of the document. > > > How about: > > 3.4. Tree Diagrams > > YANG tree diagrams provide a concise representation of a YANG module > and SHOULD be included to help readers understand YANG module > structure. Guidelines on tree diagrams can be found in Section 3 of > [RFC8340] and SHOULD be followed. > > Thanks, > > Lou > > On 11/14/2024 2:56 AM, [email protected] wrote: > > Hi all, > > > > This version implements the changes discussed in Dublin, especially to > > address the comments about long trees (Lou) and better organize the > > commentary text in the sec template (Rob). > > > > Kent, it seems that you had a comment about clarifying "long lines" (?) but > > I fail to see which part you were referring to, especially that there are > > no occurrences of "lines" or "long line" in -21. May be this was related to > > some of the text removed to address the comment from Lou? > > > > Unless Kent still think a new rev is needed (and assuming he provides text > > :-)), I think this version is ready to be sent to the IESG. > > > > Thank you. > > > > Cheers, > > Med > > > > > -----Message d'origine----- > > > De :[email protected] <[email protected]> > > > Envoyé : jeudi 14 novembre 2024 08:43 > > > À :[email protected] > > > Cc :[email protected] > > > Objet : I-D Action: draft-ietf-netmod-rfc8407bis-21.txt > > > > > > > > > Internet-Draft draft-ietf-netmod-rfc8407bis-21.txt is now > > > available. It is a work item of the Network Modeling (NETMOD) WG > > > of the IETF. > > > > > > Title: Guidelines for Authors and Reviewers of Documents > > > Containing YANG Data Models > > > Authors: Andy Bierman > > > Mohamed Boucadair > > > Qin Wu > > > Name: draft-ietf-netmod-rfc8407bis-21.txt > > > Pages: 93 > > > Dates: 2024-11-13 > > > > > > Abstract: > > > > > > This memo provides guidelines for authors and reviewers of > > > specifications containing YANG modules, including IANA- > > > maintained > > > modules. Recommendations and procedures are defined, which > > > are > > > intended to increase interoperability and usability of Network > > > Configuration Protocol (NETCONF) and RESTCONF protocol > > > implementations that utilize YANG modules. This document > > > obsoletes > > > RFC 8407. > > > > > > Also, this document updates RFC 8126 by providing additional > > > guidelines for writing the IANA considerations for RFCs that > > > specify > > > IANA-maintained modules. The document also updates RFC 6020 > > > by > > > clarifying how modules and their revisions are handled by > > > IANA. > > > > > > The IETF datatracker status page for this Internet-Draft is: > > > https://eur03.safelinks.protection.outlook.com/?url=https%3A%2F%2 > > > Fdatatracker.ietf.org%2Fdoc%2Fdraft-ietf-netmod- > > > rfc8407bis%2F&data=05%7C02%7Cmohamed.boucadair%40orange.com%7C4ae > > > ea5b9e9654b719a2308dd048011cb%7C90c7a20af34b40bfbc48b9253b6f5d20% > > > 7C0%7C0%7C638671670286827006%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1h > > > cGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsI > > > ldUIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=TgPG%2BoExl6Z9GN27ifA%2FaXYeny > > > juNEjhs%2BGPyqbC8pc%3D&reserved=0 > > > > > > There is also an HTML version available at: > > > https://eur03.safelinks.protection.outlook.com/?url=https%3A%2F%2 > > > Fwww.ietf.org%2Farchive%2Fid%2Fdraft-ietf-netmod-rfc8407bis- > > > 21.html&data=05%7C02%7Cmohamed.boucadair%40orange.com%7C4aeea5b9e > > > 9654b719a2308dd048011cb%7C90c7a20af34b40bfbc48b9253b6f5d20%7C0%7C > > > 0%7C638671670286853445%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOn > > > RydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjo > > > yfQ%3D%3D%7C0%7C%7C%7C&sdata=VkB16NFtocbYQX5eL44D0EQaEGqrx6%2F3KG > > > B7urTEbl4%3D&reserved=0 > > > > > > A diff from the previous version is available at: > > > https://eur03.safelinks.protection.outlook.com/?url=https%3A%2F%2 > > > Fauthor-tools.ietf.org%2Fiddiff%3Furl2%3Ddraft-ietf-netmod- > > > rfc8407bis- > > > 21&data=05%7C02%7Cmohamed.boucadair%40orange.com%7C4aeea5b9e9654b > > > 719a2308dd048011cb%7C90c7a20af34b40bfbc48b9253b6f5d20%7C0%7C0%7C6 > > > 38671670286867934%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWU > > > sIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3 > > > D%3D%7C0%7C%7C%7C&sdata=V9MbbyKxm79Vx7qiOfDngiaYB%2FPWBNsCzGxuYK2 > > > EvI4%3D&reserved=0 > > > > > > Internet-Drafts are also available by rsync at: > > > rsync.ietf.org::internet-drafts > > > > > > > > > _______________________________________________ > > > I-D-Announce mailing list [email protected] To unsubscribe > > > send an email [email protected] > > ____________________________________________________________________________________________________________ > > Ce message et ses pieces jointes peuvent contenir des informations > > confidentielles ou privilegiees et ne doivent donc > > pas etre diffuses, exploites ou copies sans autorisation. Si vous avez recu > > ce message par erreur, veuillez le signaler > > a l'expediteur et le detruire ainsi que les pieces jointes. Les messages > > electroniques etant susceptibles d'alteration, > > Orange decline toute responsabilite si ce message a ete altere, deforme ou > > falsifie. Merci. > > > > This message and its attachments may contain confidential or privileged > > information that may be protected by law; > > they should not be distributed, used or copied without authorisation. > > If you have received this email in error, please notify the sender and > > delete this message and its attachments. > > As emails may be altered, Orange is not liable for messages that have been > > modified, changed or falsified. > > Thank you. > > > _______________________________________________ > netmod mailing list -- [email protected] > To unsubscribe send an email to [email protected] -- Jürgen Schönwälder Constructor University Bremen gGmbH Phone: +49 421 200 3587 Campus Ring 1 | 28759 Bremen | Germany _______________________________________________ netmod mailing list -- [email protected] To unsubscribe send an email to [email protected]
