Hi, On 9. 10. 2025 22:29, Per Andersson wrote:
On Thu, Oct 9, 2025 at 4:57 PM Joe Clarke (jclarke) <[email protected]> wrote:Thanks for doing this work (to both you and Michal).My first comment is that this could really benefit from an example output in an appendix as there is a lot to digest in the algorithm. And perhaps example snippets in the various paragraphs that describe things like data node and non-data node comparisons.Yes, that will most definitely be added.
+1
This feels like YANG structure than something that would be defined in a datastore, yes? I don’t imagine that a device would preserve two or more copies of its schema.That is a good point.
+1
I see revision is included but nothing about YANG Semver. What we were doing in YANG Catalog was attempting (albeit less rigorously than is defined here) to dervice a YANG Semver based on a schema comparison. Providing some notion of that here would be helpful. Obviously, if both modules have a YANG Semver, those can be displayed in the output. But if, say, the latter does not, that could be derived based on the changes detected.Am I reading it correctly that you mean derive a new YANG Semver for the updated module depending on the diff?
This is the way I understood the suggestion and it was the initial intention but for now the schema-comparison can only distinguish between NBC and BC changes, 'editorial' changes are simply treated as BC. The reason for this is that tooling can reasonably detect these 2 categories of changes (an extension instance still needs to be used in some cases). Editorial changes could automatically be detected only by explicitly telling the tool that a specific change is editorial (by using another extension instance, for example). This did not seem like it adds any real information and would just clutter YANG modules with more extensions. Up for further discussion on Tuesday.
Michal
-- PerJoe From: Per Andersson <[email protected]> Date: Thursday, October 9, 2025 at 07:37 To: [email protected] <[email protected]> Subject: [netmod] Re: I-D Action: draft-ietf-netmod-yang-schema-comparison-03.txt Hi! A new version of yang-schema-comparison with changes reflecting implementation in yanglint. The document now has updated the YANG module and the description of how the implemented algorithm works. Other than that there are some editorial changes and additions like introducing a Security Considerations section and correcting the IANA Considerations section. -- Per On Thu, Oct 9, 2025 at 1:25 PM <[email protected]> wrote:Internet-Draft draft-ietf-netmod-yang-schema-comparison-03.txt is now available. It is a work item of the Network Modeling (NETMOD) WG of the IETF. Title: YANG Schema Comparison Authors: Per Andersson Robert Wilton Michal Vaško Name: draft-ietf-netmod-yang-schema-comparison-03.txt Pages: 30 Dates: 2025-10-09 Abstract: This document specifies an algorithm for comparing two revisions of a YANG schema to determine the scope of changes, and a list of changes, between the revisions. The output of the algorithm can be used to help select an appropriate revision-label or YANG semantic version number for a new revision. Included is also a YANG module describing the output of this algorithm. The IETF datatracker status page for this Internet-Draft is: https://datatracker.ietf.org/doc/draft-ietf-netmod-yang-schema-comparison/ There is also an HTMLized version available at: https://datatracker.ietf.org/doc/html/draft-ietf-netmod-yang-schema-comparison-03 A diff from the previous version is available at: https://author-tools.ietf.org/iddiff?url2=draft-ietf-netmod-yang-schema-comparison-03 Internet-Drafts are also available by rsync at: rsync.ietf.org::internet-drafts _______________________________________________ netmod mailing list -- [email protected] To unsubscribe send an email to [email protected]_______________________________________________ netmod mailing list -- [email protected] To unsubscribe send an email to [email protected]_______________________________________________ netmod mailing list -- [email protected] To unsubscribe send an email to [email protected]
smime.p7s
Description: S/MIME Cryptographic Signature
_______________________________________________ netmod mailing list -- [email protected] To unsubscribe send an email to [email protected]
