Re: [netmod] I-D Action: draft-ietf-netmod-rfc8407bis-01.txt

[[e-mail]]

Hi all, 

This version implements the following changes: 

* Elaborate the guidance for the use of values reserved for documentation in examples.	 		
* Recommended the use of "example:" for URI examples.	
* Added a new section "Defining Standard Tags" to echo the guidance in [RFC8819].	
* Recommended against the use of "case + when" construct.	
* Added a discussion about the prefix pattern to use for example modules.	
* Added a statement for NMDA to be listed as normative reference.	
* Added a new section about YANG module classification.
* Added a reco about the naming conventions of lists. 
* Added a mention that the security template is also relaxed for extensions such as RFC7952
* Reorder the sections so that we keep a 1:1 mapping of level 1 sections vs. RFC8407. 

Please review and share your comments. Also, feel free to raise issues or propose PRs via https://github.com/boucadair/rfc8407bis. 

FWIW, as part of the discussion to rfc7950#section-11, I noted the proposal to fix that as part of the 8407bis (https://github.com/boucadair/rfc8407bis/issues/5). 

Cheers,
Med

> -----Message d'origine-----
> De : netmod <[e-mail]> De la part de internet-
> [e-mail]
> Envoyé : mercredi 18 octobre 2023 14:35
> À : [e-mail]
> Cc : [e-mail]
> Objet : [netmod] I-D Action: draft-ietf-netmod-rfc8407bis-01.txt
> 
> Internet-Draft draft-ietf-netmod-rfc8407bis-01.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: Mohamed Boucadair
>             Qin Wu
>    Name:    draft-ietf-netmod-rfc8407bis-01.txt
>    Pages:   76
>    Dates:   2023-10-18
> 
> 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 IETF datatracker status page for this Internet-Draft is:
> https://eur03.safelinks.protection.outlook.com/?url=https%3A%2F%2Fdata
> tracker.ietf.org%2Fdoc%2Fdraft-ietf-netmod-
> rfc8407bis%2F&data=05%7C01%7Cmohamed.boucadair%40orange.com%7Cb5e63a63
> 8a434fa012d208dbcfd6b904%7C90c7a20af34b40bfbc48b9253b6f5d20%7C0%7C0%7C
> 638332293348272681%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjo
> iV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C3000%7C%7C%7C&sdata=TiFpP1ev
> EAf0%2BwKLLz8maDt1s1S4UVylv2k4q7eBpDg%3D&reserved=0
> 
> There is also an HTML version available at:
> https://eur03.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwww.
> ietf.org%2Farchive%2Fid%2Fdraft-ietf-netmod-rfc8407bis-
> 01.html&data=05%7C01%7Cmohamed.boucadair%40orange.com%7Cb5e63a638a434f
> a012d208dbcfd6b904%7C90c7a20af34b40bfbc48b9253b6f5d20%7C0%7C0%7C638332
> 293348272681%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luM
> zIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C3000%7C%7C%7C&sdata=KTbrMswBNlji4x
> o5F1jYfw66BkJDyKRPnR6T4tvdH9k%3D&reserved=0
> 
> A diff from the previous version is available at:
> https://eur03.safelinks.protection.outlook.com/?url=https%3A%2F%2Fauth
> or-tools.ietf.org%2Fiddiff%3Furl2%3Ddraft-ietf-netmod-rfc8407bis-
> 01&data=05%7C01%7Cmohamed.boucadair%40orange.com%7Cb5e63a638a434fa012d
> 208dbcfd6b904%7C90c7a20af34b40bfbc48b9253b6f5d20%7C0%7C0%7C63833229334
> 8272681%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLC
> JBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C3000%7C%7C%7C&sdata=vjxPXNzjeJ5H%2FS%2B
> %2B7d604PMQqlWQljNv%2FpjSHt0i6Bc%3D&reserved=0
> 
> Internet-Drafts are also available by rsync at:
> rsync.ietf.org::internet-drafts
> 
> 
> _______________________________________________
> netmod mailing list
> [e-mail]
> https://eur03.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwww.
> ietf.org%2Fmailman%2Flistinfo%2Fnetmod&data=05%7C01%7Cmohamed.boucadai
> r%40orange.com%7Cb5e63a638a434fa012d208dbcfd6b904%7C90c7a20af34b40bfbc
> 48b9253b6f5d20%7C0%7C0%7C638332293348272681%7CUnknown%7CTWFpbGZsb3d8ey
> JWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C300
> 0%7C%7C%7C&sdata=niDXAt%2Flwt2A%2FH8mL1sW3pwGImgJGMJNImbPgJSuoQg%3D&re
> served=0
____________________________________________________________________________________________________________
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.