Re: [netmod] I-D Action: draft-ietf-netmod-yang-semver-14.txt

["Joe Clarke (jclarke)" <[e-mail]>]

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 <[e-mail]> on behalf of [e-mail] <[e-mail]>
Date: Monday, March 4, 2024 at 14:47
To: [e-mail] <[e-mail]>
Cc: [e-mail] <[e-mail]>
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
[e-mail]
https://www.ietf.org/mailman/listinfo/netmod