Differences

This shows you the differences between two versions of the page.

--- yang-ietf123 [2025/07/20 08:54] – sginoza
+++ yang-ietf123 [2026/02/12 05:44] (current) – external edit 127.0.0.1
@@ Line 65: / Line 65: @@
 These are some quick examples of possible issues with references in YANG modules for the meeting between RPC and YANG ODs during IETF 123 on 20 July 2025.
+**Discussion (7/20/2025):**
+Issues:
+  * Q: What should the intro text cover?  References should be captured as document reference.
+    * A: should contain all RFCs that module is referencing, directly or indirectly.
+    * format: RFC XXXX: title, section.
+need tool to check refs in module match intro text.
+no currently defined guidance to authors on how to do intro text.
+In addition to references already cited, this module also references/imports from:
+intentional:
+- not enforcing that intro text be comprehensive
+- allowing intro text to refer to IMPORTs and/or references
+Need to clarify how it works if YANG modules are removed from RFC before publication.
+Consider: if modules removed from the document, then they won't be read by the editor.
+Reference format:
+- add section number example to 8407bis
+should not include "topics" or "keywords" - specify sections, table, etc.
 ==== RFCs mentioned in introduction sentence - not referenced in YANG module ====
@@ Line 234: / Line 260: @@
 RPC still needs check to catch these if author has not addressed the issue.
 How to check for this?
+How to actively notify draft authors?
+- intended status notifications?
+- referenced by notifications?