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

"Joe Clarke (jclarke)" <jclarke@cisco.com> Mon, 13 July 2020 21:18 UTC

Return-Path: <jclarke@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 08F653A0B70; Mon, 13 Jul 2020 14:18:40 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -9.62
X-Spam-Level:
X-Spam-Status: No, score=-9.62 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_MSPIKE_H4=-0.01, RCVD_IN_MSPIKE_WL=-0.01, SPF_PASS=-0.001, URIBL_BLOCKED=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=e/Q4vVhf; dkim=pass (1024-bit key) header.d=cisco.onmicrosoft.com header.b=HsNLtRtj
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 ISO59u-0YIPa; Mon, 13 Jul 2020 14:18:37 -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 B6CE83A0A2E; Mon, 13 Jul 2020 14:18:07 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=cisco.com; i=@cisco.com; l=3360; q=dns/txt; s=iport; t=1594675087; x=1595884687; h=from:to:cc:subject:date:message-id:references: in-reply-to:content-id:content-transfer-encoding: mime-version; bh=K7pnPpKht77jxruKnLrZnpn85RrCf8QTOlOSAhmhB/k=; b=e/Q4vVhfpiZNySbW6MM0hQRROcdlcpP9xyjn7+9K4BhkTxZx18f6cLza n5hm554IOFUsFr2pnYvshl2qc1ClrNBIRaDQp2az6xIt8cH+8b/aA2fAz ozF4/wUoTfPq60hGt9g3rcP9uX/tCByjV8eWQb2kdkcjrC7wOpoaPsau+ Y=;
IronPort-PHdr: 9a23:274olBb/H1wdW28T8Ju70BH/LSx94ef9IxIV55w7irlHbqWk+dH4MVfC4el21QaTD4TW9/wCjPDZ4OjsWm0FtJCGtn1KMJlBTAQMhshemQs8SNWEBkv2IL+PDWQ6Ec1OWUUj8yS9Nk5YS8fze1OUpWe9vnYeHxzlPl9zIeL4UofZk8Ww0bW0/JveKwVFjTawe/V8NhKz+A7QrcIRx4BlL/U8
X-IronPort-Anti-Spam-Filtered: true
X-IronPort-Anti-Spam-Result: A0AWBwAEzwxf/5pdJa1gHAEBAQEBAQcBARIBAQQEAQFAgUqBUlEHb1gvLAqDaUCDRgONLCWYXoJTA1ULAQEBDAEBGAsKAgQBAYQIRAIXggMCJDgTAgMBAQsBAQUBAQECAQYEbYVbAQuFbwEBAQECAQEBCgYREQwBASwLAQQLAgEGAhgCAiYCAgIlCxUQAgQOBSKDBAGCSwMOIAEOjgaQaAKBOYhhdoEygwEBAQWBNgIOQUKCYBiCDgmBDiqCaoNVhjMagUE/gREnDBCCTT6CXAEBAgEBFYFFAYMWM4ItkkOiXQqCXYhRkQcDHoJ0gRuIG5MAkWyKIpEAg1ICBAIEBQIOAQEFgWojgVdwFRohKgGCPgk1EhcCDY4eg3GFFIVCdDcCBgEHAQEDCXyOPAGBEAEB
X-IronPort-AV: E=Sophos;i="5.75,348,1589241600"; d="scan'208";a="542751720"
Received: from rcdn-core-3.cisco.com ([173.37.93.154]) by alln-iport-6.cisco.com with ESMTP/TLS/DHE-RSA-SEED-SHA; 13 Jul 2020 21:18:06 +0000
Received: from XCH-ALN-002.cisco.com (xch-aln-002.cisco.com [173.36.7.12]) by rcdn-core-3.cisco.com (8.15.2/8.15.2) with ESMTPS id 06DLI5eP013317 (version=TLSv1.2 cipher=AES256-SHA bits=256 verify=FAIL); Mon, 13 Jul 2020 21:18:06 GMT
Received: from xhs-rcd-001.cisco.com (173.37.227.246) by XCH-ALN-002.cisco.com (173.36.7.12) with Microsoft SMTP Server (TLS) id 15.0.1497.2; Mon, 13 Jul 2020 16:18:05 -0500
Received: from xhs-rcd-003.cisco.com (173.37.227.248) by xhs-rcd-001.cisco.com (173.37.227.246) with Microsoft SMTP Server (TLS) id 15.0.1497.2; Mon, 13 Jul 2020 16:18:04 -0500
Received: from NAM04-BN3-obe.outbound.protection.outlook.com (72.163.14.9) by xhs-rcd-003.cisco.com (173.37.227.248) with Microsoft SMTP Server (TLS) id 15.0.1497.2 via Frontend Transport; Mon, 13 Jul 2020 16:18:04 -0500
ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=Mc63vdCH6cO7S8BQQdsPkBvrqIuFEEeBBQWLWUf1YVlHN83EybpKOmTIZGlt1q3/J7S4vLMWWgcxDXBKJ6jb2eTBlWdXYnFXdFmZaGFzmgmZfzwmWMrPplMxCr4IZeXRtmzOJjvJFUUcHWZlk8USb0KLIaI/xfhm/fuE00nevDo9imfqccZtaF4sKDHwPo3zcvMHU8Gmsa19Jq2FQQJ0BnBdEQgHqi3/w6G70nnGCw3XviKZpjPIgGVNEeHhjz023KjCu5Nq5jnlNjUOk1O9EUH2My5mZFjFgQmJnnKhRXPjXoXB5t5WEsTdFhEYglywJ6Upzjf+ef05cHJpczzFmg==
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=K7pnPpKht77jxruKnLrZnpn85RrCf8QTOlOSAhmhB/k=; b=armx4Q9MbexSwOxjIhPQzNCQhZCOnQvd27AR2/82Hz8YpfpTaC+VYhAmtOGFn2xrGhBg4KBFiu9LxWu+qHL6IkBOVu5qg73UCswZ4CdOfDCEQvmDKhy+64gQPZahAakS7IGRRWfso8zko8uu+OHvw23RgsEizCFECXQTnGAbUGS9YIIdfZzsZbvCAmx1nY3QHVCop+6fl/l3eHgRXiVUNgdVwDUbInn1J5aflhdxPLSjo1+pIkxLCNdSIaETEStt/URzRp/HjdLFowGFUNIjH2eumm+1E229zhSXYKzw17e6h1U5Mx+g7hwA1ONHTDP92X/YoJ2+sVzNs15aEiOs2g==
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=K7pnPpKht77jxruKnLrZnpn85RrCf8QTOlOSAhmhB/k=; b=HsNLtRtjnPbq/jyiQkWLTJ6YbhXkrezsfUEuNNG1gY5m5ZhyWUZ3peNt0KiPxGMz/uXqR3/E5dlADehE8ZzvX2+VxC2f0jcbWLW88g8VxJqyRRfL1lWqwoffMoJeoqqDkZpAiuMSeo1W28py7pPNVfteUkz6pEAoMnJkMCA0CYg=
Received: from BN6PR11MB1667.namprd11.prod.outlook.com (2603:10b6:405:e::12) by BN8PR11MB3731.namprd11.prod.outlook.com (2603:10b6:408:8b::27) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3174.22; Mon, 13 Jul 2020 21:18:03 +0000
Received: from BN6PR11MB1667.namprd11.prod.outlook.com ([fe80::2949:27ee:578f:1a83]) by BN6PR11MB1667.namprd11.prod.outlook.com ([fe80::2949:27ee:578f:1a83%3]) with mapi id 15.20.3174.025; Mon, 13 Jul 2020 21:18:03 +0000
From: "Joe Clarke (jclarke)" <jclarke@cisco.com>
To: "netmod@ietf.org" <netmod@ietf.org>
CC: "i-d-announce@ietf.org" <i-d-announce@ietf.org>
Thread-Topic: [netmod] I-D Action: draft-ietf-netmod-yang-semver-01.txt
Thread-Index: AQHWWVc9+LPlY0X9FE2/k4Sz8GDDrKkGA38A
Date: Mon, 13 Jul 2020 21:18:03 +0000
Message-ID: <1F32F8B1-3DF4-4B9E-9072-265C13A372C7@cisco.com>
References: <159467341597.16298.3462716507326050610@ietfa.amsl.com>
In-Reply-To: <159467341597.16298.3462716507326050610@ietfa.amsl.com>
Accept-Language: en-US
Content-Language: en-US
X-MS-Has-Attach:
X-MS-TNEF-Correlator:
x-mailer: Apple Mail (2.3608.80.23.2.2)
authentication-results: ietf.org; dkim=none (message not signed) header.d=none;ietf.org; dmarc=none action=none header.from=cisco.com;
x-originating-ip: [173.38.117.91]
x-ms-publictraffictype: Email
x-ms-office365-filtering-correlation-id: 18293ac4-b782-4b5b-9d70-08d827723a8e
x-ms-traffictypediagnostic: BN8PR11MB3731:
x-microsoft-antispam-prvs: <BN8PR11MB3731376B37DF9F3707B09AC4B8600@BN8PR11MB3731.namprd11.prod.outlook.com>
x-ms-oob-tlc-oobclassifiers: OLM:8882;
x-ms-exchange-senderadcheck: 1
x-microsoft-antispam: BCL:0;
x-microsoft-antispam-message-info: KWSro5GMMSgfaHwYHbeHrgxpRXUX24KC0NEpjbGVKCEAPCZ34ZYrDQbLXxW4eWcz1qTmsrxNKRwHRXAmUKbpHcuWkiBrqzp2pByqLKWXD2y4ZkPJC5hGqBrn58HBQ8Oteby1Kb3m2yRPD0MC5GvLcX0N1NnNAAQ8/DJU2P5wp6P5Qq+pVn0EX/Lc4kzLYxmVZrw0Hfda7vd/DArdAqhM/asZh4qdkNpDz7CTY4x8u+68SVaJy/gbOaAcgPpZRVO+BgyDJmi/GbgMhyVLblc0Fd0yp2aXPPtmNffx2cbYLYPeRbwf2wagG0Irk0dzSAV4+lakGexRRL99RlVIm97sZl1qTlFPkOGoBOdaqUx9CN5LLwUM1h1mz4mQoi2qlEMBUjJAmk3v2QNODd5JkVpypA==
x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:BN6PR11MB1667.namprd11.prod.outlook.com; PTR:; CAT:NONE; SFTY:; SFS:(4636009)(366004)(376002)(346002)(39860400002)(136003)(396003)(26005)(2906002)(8676002)(86362001)(186003)(450100002)(71200400001)(66476007)(53546011)(316002)(66446008)(64756008)(36756003)(478600001)(6506007)(66556008)(66946007)(76116006)(91956017)(4326008)(2616005)(966005)(8936002)(66574015)(6486002)(33656002)(6916009)(6512007)(5660300002); DIR:OUT; SFP:1101;
x-ms-exchange-antispam-messagedata: jPG3Tt2zsMvxYCPl/xWHPZ2enHCcaWJrh24MflUVmFbwlJkRm8krgscXSJVQZVz7cvDt3Xx6Ilr1K/H3VFw8w8igPdhtzkle1YObBHgcmzkpJrdIw3EXja5TPzBOK3S34S+FGq5vICs/hB68U7NSlmmVPtCLLtJcXM2iWcbQjAfQ2PZ1JgZtuDRGBLN7wV/vMZ1iSsbHtnMdQ32ZHX7eJn7THsL68acYVpIdugrpssASsszsTUnQFGsjpQRCip/XP7s79AdbEjGOPQisQxRVpD9QT2B1oAGJvLpPTItB7Wkr2lsqqMQSsRaJaHRcOP1IfcGvwaDI5eR+phidVKLJIbLBgQFjdnQuxgA+tlnBpi0CrFZBeDlj0MX6lL97tGMm6ZYrOGK6TxQqAib2fAY8JiVwEjsjr/Mr54qJFuDxl2PaVQw2FPccQmMtRivVcEKEDomGQe2lq7TuB+RDYThwOoQdhZdXKf0MzNmBPzJOfb8QyUnczZYNfIO2Y8qJvN6Z
x-ms-exchange-transport-forked: True
Content-Type: text/plain; charset="utf-8"
Content-ID: <32B4B6702B73474CACD3075F2B4C49FE@namprd11.prod.outlook.com>
Content-Transfer-Encoding: base64
MIME-Version: 1.0
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-AuthSource: BN6PR11MB1667.namprd11.prod.outlook.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 18293ac4-b782-4b5b-9d70-08d827723a8e
X-MS-Exchange-CrossTenant-originalarrivaltime: 13 Jul 2020 21:18:03.3465 (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: jrZ0+DaPPimJsKju8qPRjE4WRYfwzYPyKPwRzlY0dnxviy7XUYJOxhoDdd//5so6dgTEhie0+RPFC/m6gomTQg==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: BN8PR11MB3731
X-OriginatorOrg: cisco.com
X-Outbound-SMTP-Client: 173.36.7.12, xch-aln-002.cisco.com
X-Outbound-Node: rcdn-core-3.cisco.com
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/eQXUrBlizZdzvZuvCPOnwGodmlE>
Subject: Re: [netmod] I-D Action: draft-ietf-netmod-yang-semver-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: Mon, 13 Jul 2020 21:18:40 -0000

This represents a lot of work taken from weekly meeting discussions, list items, and GitHub issues:

* Change the ‘m’ and ‘M’ to ‘_compatible’ and ‘_non_compatible’
* Present guidelines on how to do semver revision-labels for module development (including examples)
* Define a revision-label scheme for YANG semver
* Remove text that says that any pattern that matches the YANG semver regex must be a YANG semver
* Modernize draft references
* Fix typos

One new TODO is GitHub Issue #60 which is to decide on what to do with development YANG semver revision-labels going backwards during module development.

Joe

> On Jul 13, 2020, at 16:50, internet-drafts@ietf.org wrote:
> 
> 
> A New Internet-Draft is available from the on-line Internet-Drafts directories.
> This draft is a work item of the Network Modeling WG of the IETF.
> 
>        Title           : YANG Semantic Versioning
>        Authors         : Benoit Claise
>                          Joe Clarke
>                          Reshad Rahman
>                          Robert Wilton
>                          Balazs Lengyel
>                          Jason Sterne
>                          Kevin D'Souza
> 	Filename        : draft-ietf-netmod-yang-semver-01.txt
> 	Pages           : 20
> 	Date            : 2020-07-13
> 
> Abstract:
>   This document specifies a scheme and guidelines for applying a
>   modified set of semantic versioning rules to revisions of YANG
>   modules.  Additionally, this document defines a revision-label for
>   this modified semver scheme.
> 
> 
> The IETF datatracker status page for this draft is:
> https://datatracker.ietf.org/doc/draft-ietf-netmod-yang-semver/
> 
> There are also htmlized versions available at:
> https://tools.ietf.org/html/draft-ietf-netmod-yang-semver-01
> https://datatracker.ietf.org/doc/html/draft-ietf-netmod-yang-semver-01
> 
> A diff from the previous version is available at:
> https://www.ietf.org/rfcdiff?url2=draft-ietf-netmod-yang-semver-01
> 
> 
> 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.
> 
> Internet-Drafts are also available by anonymous FTP at:
> ftp://ftp.ietf.org/internet-drafts/
> 
> 
> _______________________________________________
> netmod mailing list
> netmod@ietf.org
> https://www.ietf.org/mailman/listinfo/netmod