[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

Return-Path: <rwilton@cisco.com>
X-Original-To: netmod@ietfa.amsl.com
Delivered-To: netmod@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 814951200F6 for <netmod@ietfa.amsl.com>; Tue, 15 Oct 2019 04:15:55 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -14.501
X-Spam-Level:
X-Spam-Status: No, score=-14.501 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, RCVD_IN_DNSWL_HI=-5, SPF_PASS=-0.001, USER_IN_DEF_DKIM_WL=-7.5] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=cisco.com header.b=PxrLqXn2; dkim=pass (1024-bit key) header.d=cisco.onmicrosoft.com header.b=Id0OsOFv
Received: from mail.ietf.org ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 3rKmJPWojXXf for <netmod@ietfa.amsl.com>; Tue, 15 Oct 2019 04:15:53 -0700 (PDT)
Received: from alln-iport-6.cisco.com (alln-iport-6.cisco.com [173.37.142.93]) (using TLSv1.2 with cipher DHE-RSA-SEED-SHA (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 06B4B1200DF for <netmod@ietf.org>; Tue, 15 Oct 2019 04:15:52 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=cisco.com; i=@cisco.com; l=4352; q=dns/txt; s=iport; t=1571138153; x=1572347753; h=from:to:subject:date:message-id:references:in-reply-to: content-transfer-encoding:mime-version; bh=TQWJwPKCsgZCjgfMwFD/xdXyt9R3hQGKXkA6lRd5gU0=; b=PxrLqXn2Cke06nRHC4TlI/XQACpUux5xWjsfr8MJ7qqI9hsRrIPcgOTv csHtA2lkYF1s/vJBRg7Qb/tkABkm07XR/KK6KffzvyZq8ADljYT0qisru ZicZt7FZnYCgkO9Id4ebVt3iMvFTnDD0Z3xMFoWO1sVPW2fIsQpX0RCPQ U=;
IronPort-PHdr: =?us-ascii?q?9a23=3AFx+CrRC4QndoecSFFOh0UyQJPHJ1sqjoPgMT9p?= =?us-ascii?q?ssgq5PdaLm5Zn5IUjD/qs13kTRU9Dd7PRJw6rNvqbsVHZIwK7JsWtKMfkuHw?= =?us-ascii?q?QAld1QmgUhBMCfDkiuNuHrazA9GuxJVURu+DewNk0GUMs=3D?=
X-IronPort-Anti-Spam-Filtered: true
X-IronPort-Anti-Spam-Result: =?us-ascii?q?A0BlAAAFqaVd/5JdJa1mHAEBAQEBBwE?= =?us-ascii?q?BEQEEBAEBgWcHAQELAYFKUAVsVyAECyoKhBuDRwOEWIVxTYIPl36BLoEkA1Q?= =?us-ascii?q?JAQEBDAEBJQgCAQGEQAIXglMkNAkOAgMJAQEEAQEBAgEFBG2FLQELhUsBAQE?= =?us-ascii?q?BAxIREQwBATUDCwQCARkEAQEDAiYCAgIwFQgIAgQTCBqDAYJGAy4BAgyjcgK?= =?us-ascii?q?BOIhhdYEygn0BAQWBOAIOQYMAGIIXCYEMKAGMDRiBQD+BEUaBTn6DHwEBAgE?= =?us-ascii?q?BFoFJgwwygiyPcYVdmAAKgiKHCo4sgjpyhl2POI4xgT+GZJEYAgQCBAUCDgE?= =?us-ascii?q?BBYFSOYFYcBUagw0JRxAUgU+Dc4UUhT90AYEojn0BgSIBAQ?=
X-IronPort-AV: E=Sophos;i="5.67,299,1566864000"; d="scan'208";a="357298472"
Received: from rcdn-core-10.cisco.com ([173.37.93.146]) by alln-iport-6.cisco.com with ESMTP/TLS/DHE-RSA-SEED-SHA; 15 Oct 2019 11:15:52 +0000
Received: from XCH-ALN-004.cisco.com (xch-aln-004.cisco.com [173.36.7.14]) by rcdn-core-10.cisco.com (8.15.2/8.15.2) with ESMTPS id x9FBFqmq018191 (version=TLSv1.2 cipher=AES256-SHA bits=256 verify=FAIL) for <netmod@ietf.org>; Tue, 15 Oct 2019 11:15:52 GMT
Received: from xhs-rtp-003.cisco.com (64.101.210.230) by XCH-ALN-004.cisco.com (173.36.7.14) with Microsoft SMTP Server (TLS) id 15.0.1473.3; Tue, 15 Oct 2019 06:15:51 -0500
Received: from xhs-rtp-002.cisco.com (64.101.210.229) by xhs-rtp-003.cisco.com (64.101.210.230) with Microsoft SMTP Server (TLS) id 15.0.1473.3; Tue, 15 Oct 2019 07:15:50 -0400
Received: from NAM01-SN1-obe.outbound.protection.outlook.com (64.101.32.56) by xhs-rtp-002.cisco.com (64.101.210.229) with Microsoft SMTP Server (TLS) id 15.0.1473.3 via Frontend Transport; Tue, 15 Oct 2019 07:15:50 -0400
ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=Hz7oyJJYHuys78vmsyu9ychFR9wv8sGYy3TLanv0R3CQU5J5t7fubD996+9EBAMD1atLeUF8h74tZYM/DPC2ofXv2dzLmz7fkZ5XZQ1ukSQnFfRcNtOHhl8CCmxMqLmBzJYvUNZ8S9DczT6O6O8k3pbXVdq9L0nvOEZwMYvhvc/3V/7hmEKkK7IZiLC5pY7AMYcCNsW+rlx7O6Jn5L+Lvb396nXrQngBrkFaVShC60KT5RGnkxsDAoMZ2ey3z/ieoZXJywW41yBSQuFoodWNJgaWdtEt7uWMNpTxjp9lWMTkJ9Sn1Kjh8p5vHA/tWv+VN2Qi7Z+FBLc1IV9JBfgM0w==
ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=TQWJwPKCsgZCjgfMwFD/xdXyt9R3hQGKXkA6lRd5gU0=; b=NFn1e1GeV4+NKM2QPDOBhuBhSh51mgp2Y58uKdVSp5K5+IR3ZJdJwk/qCaTT4QYbf7BqB/AfyhxbQlDOFt9phpRaubp4N0U4QuA3LO2wJoRGb6h1Ez+kfcZSTirtPp/1y19FPZ+6kSy0rT7Ff263OVf80hcDOjzTEyZLL9WmXanHxFDjEMtcHc5h9b15tQ0A1FN9FWgKBZxZ+jZOQYvPdmMuLGPv6QKvgemak4FqltlrL4vYSYOlm1gqiQJl+AKYNgZpyp1xnl7gOahR7x4RdkEruEREvcrhXij4hByRORyVoJ+N4t+PlrLciDoSI/45gC6JL4630lQtNcxkZ/MBCw==
ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=cisco.com; dmarc=pass action=none header.from=cisco.com; dkim=pass header.d=cisco.com; arc=none
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=cisco.onmicrosoft.com; s=selector2-cisco-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=TQWJwPKCsgZCjgfMwFD/xdXyt9R3hQGKXkA6lRd5gU0=; b=Id0OsOFvAJQoGCaIqDxH6VM2NZ8N+hyrv61yWJN/2XD+AnNdjs8QVIBSrf236mDIhMZ97R7LGsIosQnJ8kHI7/4cp9rCLjmelMVHEjcUhlRkQDUBCogXDetEaw63xoIiovuQsmTDgzZlM+aJWYJ4YrhAaLiMrmszM/Xqn6qrjOY=
Received: from MN2PR11MB4366.namprd11.prod.outlook.com (52.135.38.209) by MN2PR11MB3920.namprd11.prod.outlook.com (10.255.181.26) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.2347.21; Tue, 15 Oct 2019 11:15:49 +0000
Received: from MN2PR11MB4366.namprd11.prod.outlook.com ([fe80::cca:41bd:b0bb:c549]) by MN2PR11MB4366.namprd11.prod.outlook.com ([fe80::cca:41bd:b0bb:c549%2]) with mapi id 15.20.2347.023; Tue, 15 Oct 2019 11:15:49 +0000
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
X-MS-Has-Attach:
X-MS-TNEF-Correlator:
authentication-results: spf=none (sender IP is ) smtp.mailfrom=rwilton@cisco.com;
x-originating-ip: [173.38.220.39]
x-ms-publictraffictype: Email
x-ms-office365-filtering-correlation-id: ee0d9bb7-2f14-4d2b-c13e-08d75161086b
x-ms-traffictypediagnostic: MN2PR11MB3920:
x-ms-exchange-purlcount: 5
x-microsoft-antispam-prvs: <MN2PR11MB39202A10111A23B098214D84B5930@MN2PR11MB3920.namprd11.prod.outlook.com>
x-ms-oob-tlc-oobclassifiers: OLM:9508;
x-forefront-prvs: 01917B1794
x-forefront-antispam-report: SFV:NSPM; SFS:(10009020)(4636009)(346002)(396003)(136003)(376002)(366004)(39860400002)(199004)(189003)(13464003)(51444003)(64756008)(1730700003)(102836004)(26005)(33656002)(6506007)(3846002)(6116002)(5660300002)(53546011)(2351001)(7696005)(76176011)(186003)(66574012)(7736002)(476003)(486006)(4001150100001)(76116006)(8676002)(15650500001)(66446008)(86362001)(25786009)(478600001)(6916009)(74316002)(66556008)(66476007)(66946007)(305945005)(81166006)(81156014)(14454004)(71190400001)(71200400001)(14444005)(52536014)(256004)(316002)(55016002)(5640700003)(966005)(66066001)(99286004)(2906002)(11346002)(446003)(8936002)(2501003)(9686003)(6436002)(6306002); DIR:OUT; SFP:1101; SCL:1; SRVR:MN2PR11MB3920; H:MN2PR11MB4366.namprd11.prod.outlook.com; FPR:; SPF:None; LANG:en; PTR:InfoNoRecords; A:1; MX:1;
received-spf: None (protection.outlook.com: cisco.com does not designate permitted sender hosts)
x-ms-exchange-senderadcheck: 1
x-microsoft-antispam: BCL:0;
x-microsoft-antispam-message-info: gvlyAjRKVpSQbstffcCBN+Mvpq+ZQMYvK9QM/x/hcQ1KCFNAI1jsPcEq6VvaJ0rgXV1msUD3jWsnO01Zn3XNG22XbjMGxzo5knB0siHlCth/+9reNUCNWZ+90zarEJWbxpDLAJxZ9PgsUSfZ1GQFfVe8YB0xHeifp6h4/F8IvDCZk0ouVc7/c/9u9FvE4s215eU2Kc6IqqWevF1F3cddM064q2TpYdOMTH4wUZy00e1x15ffL6LhS89OSCRgqmwqL1PcMlAp9k4CAUvW+UXGcW+E2vi43GCOG8VVxX4kyKeaYfmKtgcJImMpNzmS+EKaBwHPpdW/p6WiwXuQ5gl8CJPQDDnV5sbznScuvhDQYM7UuKaFFqZNcgNT17R8AvmEj2SEFr6yGIagFHrROVInsJdTplXgymtL0QXMn4k+epmWF8hgSWPD+UbvTcGqurJJQZp2SKAuPNCnkUeXLGmSZg==
x-ms-exchange-transport-forked: True
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