NETMOD WG, In conjunction with Reshad’s email on module versioning, this updated YANG Semver draft covers a lot of ground and is complimentary with that work. Many of these changes were raised on-list as part of our key issues. They were also discussed at IETF 118.
NOTE: Due to some changes moving from module versioning to Semver, I left out IANA considerations in rev -13, so I recommend people view the diff from -12 to -14 to get the full scope of the work (see https://author-tools.ietf.org/iddiff?url1=draft-ietf-netmod-yang-semver-12&url2=draft-ietf-netmod-yang-semver-14&difftype=--html) Summary of the changes: * With the removal of the revision-label-scheme, YANG Semver introduces the concept of an artifact (i.e., module or package) version. * This version is also augmented into ietf-yang-library (previously described in module versioning). * A new recommended-min-version extension was added to facilitate import by YANG Semver (and multiple recommended-min-versions are permitted). * The import rules have been simplified such that importing by recommended-min-version follows – hopefully intuitive – numeric rules. * A figure has been added in both module versioning and early-on in YANG Semver to illustrate how YANG Semver works with branching. * The namespace for YANG Semver has been renamed “ys”. So the extension for version is ys:version. Joe (on behalf of the authors and contributors) From: netmod <netmod-boun...@ietf.org> on behalf of internet-dra...@ietf.org <internet-dra...@ietf.org> Date: Monday, March 4, 2024 at 14:47 To: i-d-annou...@ietf.org <i-d-annou...@ietf.org> Cc: netmod@ietf.org <netmod@ietf.org> Subject: [netmod] I-D Action: draft-ietf-netmod-yang-semver-14.txt Internet-Draft draft-ietf-netmod-yang-semver-14.txt is now available. It is a work item of the Network Modeling (NETMOD) WG of the IETF. Title: YANG Semantic Versioning Authors: Joe Clarke Robert Wilton Reshad Rahman Balazs Lengyel Jason Sterne Benoit Claise Name: draft-ietf-netmod-yang-semver-14.txt Pages: 34 Dates: 2024-03-04 Abstract: This document specifies a YANG extension along with guidelines for applying an extended set of semantic versioning rules to revisions of YANG artifacts (e.g., modules and packages). Additionally, this document defines a YANG extension for controlling module imports based on these modified semantic versioning rules. This document updates RFCs 7950, 8407, and 8525. The IETF datatracker status page for this Internet-Draft is: https://datatracker.ietf.org/doc/draft-ietf-netmod-yang-semver/ There is also an HTML version available at: https://www.ietf.org/archive/id/draft-ietf-netmod-yang-semver-14.html A diff from the previous version is available at: https://author-tools.ietf.org/iddiff?url2=draft-ietf-netmod-yang-semver-14 Internet-Drafts are also available by rsync at: rsync.ietf.org::internet-drafts _______________________________________________ netmod mailing list netmod@ietf.org https://www.ietf.org/mailman/listinfo/netmod
_______________________________________________ netmod mailing list netmod@ietf.org https://www.ietf.org/mailman/listinfo/netmod
