[netmod] yang-module-versioning: max 1 revision label

"Sterne, Jason (Nokia - CA/Ottawa)" <jason.sterne@nokia.com> Tue, 21 April 2020 15:06 UTC

Return-Path: <jason.sterne@nokia.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 578CA3A0D2D for <netmod@ietfa.amsl.com>; Tue, 21 Apr 2020 08:06:23 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.901
X-Spam-Level:
X-Spam-Status: No, score=-1.901 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, HTML_MESSAGE=0.001, SPF_PASS=-0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=nokia.onmicrosoft.com
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 zI7uiaYG8vMS for <netmod@ietfa.amsl.com>; Tue, 21 Apr 2020 08:06:17 -0700 (PDT)
Received: from NAM02-CY1-obe.outbound.protection.outlook.com (mail-cys01nam02on071c.outbound.protection.outlook.com [IPv6:2a01:111:f400:fe45::71c]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 743883A044E for <netmod@ietf.org>; Tue, 21 Apr 2020 07:58:40 -0700 (PDT)
ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=epfuNo3QqL3EiO9vCUjMdO1Vyxv8zB8YUG9ER442Dqmjdsp0CZhA+bIdHgIOkeUDbafBG/m18NimZ8paF7fQPvSqQh8CX7HEAnx2USXeZAcBPMErkU4jLRPCHs03ryPSCzOqFrCNJJQZkeCCuf1+JF6a3+rlGqwrqqSs/YyA4zAXwaRlTmqP3ZOS1rVTrVe52REgwk5mfygxU/aRLx3ZodODWVxpV50XSpPCfrfy3ePafiH8oxjRCUEwJ6UymbsLco3ayf3szJCKSSPzzj+F3Ga4owrMefWghXvTI9Ont3+hrSmVH1DT61QCmYFwy8slj3hNvFD9w8ZvZ+e6g2kZEw==
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=nDytPqtcnshVYk/edNBg493FTE7frI0xFmVvlEET3Mo=; b=fNP5b1CQY1NnM7NfWpBYgowPjKLL38eCUtdPB6lhgpvczdHOVqxBwMvWZa+FNaYhdUb/2xz0O35WT5P4yRJ2lg0+vQMCUeeMMDRqjJDGdGAtSYTVffR4JVes6yD1gSR/TPtA+AmYGJwK3A8Y8VJ2pAWlNFP8CUIeWLDIc2wgnuV6vek5eiNC5UUMzstkN0QzTMyx+11akAg/etu+kZ9FKuPc0vE19xmd5YV2sXXnZN6xfl+oA0a0Uw2Xy8+ZUlyKcr8AlXonMB3fBBTNwegq68CXq2eYmg+Tq48Crwymnb4gY1MFr+yOA896ylZOLZhCEThWVJgjunIakaaRplF5tA==
ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=nokia.com; dmarc=pass action=none header.from=nokia.com; dkim=pass header.d=nokia.com; arc=none
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=nokia.onmicrosoft.com; s=selector1-nokia-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=nDytPqtcnshVYk/edNBg493FTE7frI0xFmVvlEET3Mo=; b=XvRzz7tLMNYoSUXaVAAXuVljC8yzLME8Kby1N+c1W+0vOoZgiPZRF+A0t62UpcfdnCAkAA605bRH3bdXaD87tXBqYvJHFKBcRJyHqvupvfCHBg/OCS9UiV8yvCkHqY/FVnCG+AWFv6raxUgJNKNs6nIo6gOm9fPWDH8TudEA6wU=
Received: from DM5PR08MB2633.namprd08.prod.outlook.com (2603:10b6:3:ca::21) by DM5PR08MB3595.namprd08.prod.outlook.com (2603:10b6:4:6b::13) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.2921.30; Tue, 21 Apr 2020 14:58:38 +0000
Received: from DM5PR08MB2633.namprd08.prod.outlook.com ([fe80::c00d:56c3:675e:ec63]) by DM5PR08MB2633.namprd08.prod.outlook.com ([fe80::c00d:56c3:675e:ec63%3]) with mapi id 15.20.2921.030; Tue, 21 Apr 2020 14:58:38 +0000
From: "Sterne, Jason (Nokia - CA/Ottawa)" <jason.sterne@nokia.com>
To: "netmod@ietf.org" <netmod@ietf.org>
Thread-Topic: yang-module-versioning: max 1 revision label
Thread-Index: AdYX7AkrWv7mvBHkSZWj5aQ/tKxy1g==
Date: Tue, 21 Apr 2020 14:58:37 +0000
Message-ID: <DM5PR08MB2633AC25E9FFDE4ADCDB90D79BD50@DM5PR08MB2633.namprd08.prod.outlook.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=jason.sterne@nokia.com;
x-originating-ip: [2607:fea8:e300:21d:557:4a81:ebe3:30bc]
x-ms-publictraffictype: Email
x-ms-office365-filtering-ht: Tenant
x-ms-office365-filtering-correlation-id: 9af1ddc5-2892-4571-2849-08d7e6047909
x-ms-traffictypediagnostic: DM5PR08MB3595:
x-microsoft-antispam-prvs: <DM5PR08MB3595A983F1240D5374C0499C9BD50@DM5PR08MB3595.namprd08.prod.outlook.com>
x-ms-oob-tlc-oobclassifiers: OLM:10000;
x-forefront-prvs: 038002787A
x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:DM5PR08MB2633.namprd08.prod.outlook.com; PTR:; CAT:NONE; SFTY:; SFS:(10019020)(4636009)(39860400002)(346002)(366004)(376002)(396003)(136003)(316002)(66476007)(64756008)(9686003)(6506007)(55016002)(2906002)(7696005)(478600001)(52536014)(8936002)(33656002)(76116006)(66946007)(71200400001)(66446008)(8676002)(66556008)(81156014)(6916009)(86362001)(186003)(5660300002); DIR:OUT; SFP:1102;
received-spf: None (protection.outlook.com: nokia.com does not designate permitted sender hosts)
x-ms-exchange-senderadcheck: 1
x-microsoft-antispam: BCL:0;
x-microsoft-antispam-message-info: e7yAwQ4GyWJf7iBGBrjCfiiXAN9cnlh5kgAwXvYS9OShmGN0+FW0I25JxbG28yjqerY7uWB81LTpGtstA7cAKKniwJDyzmjqrYAz3SYVecdvolAdvUNlChUM9vGB0lkb0hHp1frJ1MBJh0xFzCpXdJIlACBlUTS+N2PoMxsEyt+kLjaMvvExoVFbKCRKz8CogW5OId/llwBWWJ9svPShTSB4Oo/yDgYaoSfnW6J4Qe8QLYfgI+XaTqFzx+mgYi3UD+R0rt3gHo2EgPrub9/RUfnm5+2ylD0qCbULXhxGkIeHDvFBpEE/OCjansEBX4hxNWiNCbg+vlCVwNZvPBNx7iCdhuDeIVw4pqYD/2y7HZRGsOjVylDOEbHLIg9dCID9wnA5LqkIaf9CrSCXH+OH3iE6GIq0P7xJGYQTMNrzd+e+uU71SHxPAsVAWx3X6pmL
x-ms-exchange-antispam-messagedata: au6/5me8XYGHBufT8dJY+eSu9tVCLmYYq/NWhpos6TFesghxjdxDy9gKlA9GihcIcmrNMw+0LrvG4xAWfkYeHZ6qGkZnuP1zYPvWD2Zp3LdqijYYTj80Meb2ofoCzq72b0rf8MdqIDuCxhNInnLKwY0vl/5NWHE/dESsO8mA4xDyWcOtz46q5jQSrkcfuxNOk8vMKqiuWPspo65YJsH7xg==
x-ms-exchange-transport-forked: True
Content-Type: multipart/alternative; boundary="_000_DM5PR08MB2633AC25E9FFDE4ADCDB90D79BD50DM5PR08MB2633namp_"
MIME-Version: 1.0
X-OriginatorOrg: nokia.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 9af1ddc5-2892-4571-2849-08d7e6047909
X-MS-Exchange-CrossTenant-originalarrivaltime: 21 Apr 2020 14:58:37.9436 (UTC)
X-MS-Exchange-CrossTenant-fromentityheader: Hosted
X-MS-Exchange-CrossTenant-id: 5d471751-9675-428d-917b-70f44f9630b0
X-MS-Exchange-CrossTenant-mailboxtype: HOSTED
X-MS-Exchange-CrossTenant-userprincipalname: V7W7iqTYYbo8Yktr5S5hmEAYHKrfppwCYjOrcIA1zGDpFE5P7zlj8Ca1bgyrhHlfumPTxqhhf2h2IkYDM/Qyhg==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM5PR08MB3595
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/yk2n1wkoJB2u0pU2jyqYZVmuC-Y>
Subject: [netmod] yang-module-versioning: max 1 revision label
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, 21 Apr 2020 15:06:24 -0000

Hi all,

We talked about this briefly on our YANG versioning weekly call today, but we should tighten up this statement down in the YANG module:

          Each 'revision' statement MAY have a single 'revision-label' substatement.

I'd propose this instead:

          Each 'revision' statement MUST NOT have more than a single 'revision-label' substatement.

Similarly in the body of 3.3 we should change this:

   Each revision entry in a module or submodule MAY have a revision
   label associated with it, providing an alternative alias to identify
   a particular revision of a module or submodule.

to this:

   Each revision entry in a module or submodule MAY have a revision
   label associated with it, providing an alternative alias to identify
   a particular revision of a module or submodule. There MUST NOT be more
   than a single 'revision-label' substatement associated with a revision entry.

There is a similar minor ambiguity for these items as well:

          Each 'revision' statement MAY have a single 'nbc-changes' substatement.
          Each 'status' statement MAY have a single 'status-description' substatement.

Rgds,
Jason