Hi Lou, The NEW below does not mirror the intent of the OLD (it does not cover the SHOULD in the last sentence, in particular).
I prefer to keep the OLD. Cheers, Med De : Lou Berger <[email protected]> Envoyé : mardi 3 décembre 2024 00:12 À : BOUCADAIR Mohamed INNOV/NET <[email protected]>; Kent Watsen ([email protected]) <[email protected]>; [email protected] Objet : Re: I-D Action: draft-ietf-netmod-rfc8407bis-21.txt 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]<mailto:[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]<mailto:[email protected]> <[email protected]><mailto:[email protected]> Envoyé : jeudi 14 novembre 2024 08:43 À : [email protected]<mailto:[email protected]> Cc : [email protected]<mailto:[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<https://eur03.safelinks.protection.outlook.com/?url=https%3A%2F%252> 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<https://eur03.safelinks.protection.outlook.com/?url=https%3A%2F%252> 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<https://eur03.safelinks.protection.outlook.com/?url=https%3A%2F%252> 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]<mailto:[email protected]> To unsubscribe send an email to [email protected]<mailto:[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. ____________________________________________________________________________________________________________ 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]
