[netmod] New Version Notification for draft-verdt-netmod-yang-module-versioning-01.txt

"Rob Wilton (rwilton)" <rwilton@cisco.com> Tue, 15 October 2019 11:15 UTC

IronPort-PHdr: 9a23:Fx+CrRC4QndoecSFFOh0UyQJPHJ1sqjoPgMT9pssgq5PdaLm5Zn5IUjD/qs13kTRU9Dd7PRJw6rNvqbsVHZIwK7JsWtKMfkuHwQAld1QmgUhBMCfDkiuNuHrazA9GuxJVURu+DewNk0GUMs=
From: "Rob Wilton (rwilton)" <rwilton@cisco.com>
To: "netmod@ietf.org" <netmod@ietf.org>
Thread-Topic: New Version Notification for draft-verdt-netmod-yang-module-versioning-01.txt
Thread-Index: AQHVg0g28ea8twmfgEufFBvOvHmRk6dbi20A
Date: Tue, 15 Oct 2019 11:15:48 +0000
Message-ID: <MN2PR11MB4366E2BC6E417A9AF1319EA5B5930@MN2PR11MB4366.namprd11.prod.outlook.com>
References: <157113740825.18116.7601288197072920570.idtracker@ietfa.amsl.com>
In-Reply-To: <157113740825.18116.7601288197072920570.idtracker@ietfa.amsl.com>
Accept-Language: en-US
Content-Language: en-US
received-spf: None (protection.outlook.com: cisco.com does not designate permitted sender hosts)
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: base64
MIME-Version: 1.0
X-MS-Exchange-CrossTenant-Network-Message-Id: ee0d9bb7-2f14-4d2b-c13e-08d75161086b
X-MS-Exchange-CrossTenant-originalarrivaltime: 15 Oct 2019 11:15:48.9412 (UTC)
X-MS-Exchange-CrossTenant-fromentityheader: Hosted
X-MS-Exchange-CrossTenant-id: 5ae1af62-9505-4097-a69a-c1553ef7840e
X-MS-Exchange-CrossTenant-mailboxtype: HOSTED
X-MS-Exchange-CrossTenant-userprincipalname: 657tWzAoKLNgzc6DM2JDGIct4E95m6OBMPyi/CG92L1jWwMGPXzfMjGh9P6iaoxxjSHmglNfiRM5MnULtzZYZA==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: MN2PR11MB3920
X-OriginatorOrg: cisco.com
X-Outbound-SMTP-Client: 173.36.7.14, xch-aln-004.cisco.com
X-Outbound-Node: rcdn-core-10.cisco.com
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/H3aNhKnZutDah9kev--ySIeMqBI>
Subject: [netmod] New Version Notification for draft-verdt-netmod-yang-module-versioning-01.txt
X-BeenThere: netmod@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: NETMOD WG list <netmod.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/netmod>, <mailto:netmod-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/netmod/>
List-Post: <mailto:netmod@ietf.org>
List-Help: <mailto:netmod-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/netmod>, <mailto:netmod-request@ietf.org?subject=subscribe>
X-List-Received-Date: Tue, 15 Oct 2019 11:15:55 -0000

To follow up on Joe's message on the versioning work, this is a relatively minor update to the draft-verdt-netmod-yang-module-versioning-00 draft.

Probably the two key changes to be aware of are:

(1) If a revision-label looks like a YANG semver then it must be interpreted as such. 
Section 3.3:

   YANG Semver [I-D.verdt-netmod-yang-semver] defines a versioning	
   scheme based on Semver 2.0.0 [semver] that can be used as a revision	
   label.  All revision labels that match the pattern for the "version"	
   typedef in the ietf-yang-semver YANG module MUST be interpreted as	
   YANG semantic version numbers.

(2) IETF YANG modules must use YANG Semver as the format for their revision-labels.
Section 7.1:

    All IETF YANG modules MUST include revision-label statements for all	
    newly published YANG modules, and all newly published revisions of	
    existing YANG modules.  The revision-label MUST take the form of a	
    YANG semantic version number [I-D.verdt-netmod-yang-semver].

I think that the other changes are relatively minor clean up.

Thanks,
Rob


-----Original Message-----
From: internet-drafts@ietf.org <internet-drafts@ietf.org> 
Sent: 15 October 2019 12:03
To: Jason Sterne <jason.sterne@nokia.com>; Reshad Rahman (rrahman) <rrahman@cisco.com>; Rob Wilton (rwilton) <rwilton@cisco.com>; Balazs Lengyel <balazs.lengyel@ericsson.com>; Kevin D'Souza <kd6913@att.com>; Benoit Claise (bclaise) <bclaise@cisco.com>; Joe Clarke (jclarke) <jclarke@cisco.com>
Subject: New Version Notification for draft-verdt-netmod-yang-module-versioning-01.txt


A new version of I-D, draft-verdt-netmod-yang-module-versioning-01.txt
has been successfully submitted by Robert Wilton and posted to the IETF repository.

Name:		draft-verdt-netmod-yang-module-versioning
Revision:	01
Title:		Updated YANG Module Revision Handling
Document date:	2019-10-15
Group:		Individual Submission
Pages:		34
URL:            https://www.ietf.org/internet-drafts/draft-verdt-netmod-yang-module-versioning-01.txt
Status:         https://datatracker.ietf.org/doc/draft-verdt-netmod-yang-module-versioning/
Htmlized:       https://tools.ietf.org/html/draft-verdt-netmod-yang-module-versioning-01
Htmlized:       https://datatracker.ietf.org/doc/html/draft-verdt-netmod-yang-module-versioning
Diff:           https://www.ietf.org/rfcdiff?url2=draft-verdt-netmod-yang-module-versioning-01

Abstract:
   This document specifies a new YANG module update procedure that can
   document when non-backwards-compatible changes have occurred during
   the evolution of a YANG module.  It extends the YANG import statement
   with an earliest revision filter to better represent inter-module
   dependencies.  It provides help and guidelines for managing the
   lifecycle of YANG modules and individual schema nodes.  This document
   updates RFC 7950, RFC 8407 and RFC 8525.

                                                                                  


Please note that it may take a couple of minutes from the time of submission until the htmlized version and diff are available at tools.ietf.org.

The IETF Secretariat

[netmod] New Version Notification for draft-verdt… Rob Wilton (rwilton)