IETF Logo Mail Archive

Re: [netmod] module-versioning should require any solution to describe labels for drafts

"Sterne, Jason (Nokia - CA/Ottawa)" <jason.sterne@nokia.com> Mon, 22 June 2020 16:39 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 D46B73A0FC6 for <netmod@ietfa.amsl.com>; Mon, 22 Jun 2020 09:39:08 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.902
X-Spam-Level:
X-Spam-Status: No, score=-1.902 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, RCVD_IN_MSPIKE_H2=-0.001, SPF_PASS=-0.001, URIBL_BLOCKED=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 hLxomwhBUam5 for <netmod@ietfa.amsl.com>; Mon, 22 Jun 2020 09:39:07 -0700 (PDT)
Received: from NAM11-DM6-obe.outbound.protection.outlook.com (mail-dm6nam11on2105.outbound.protection.outlook.com [40.107.223.105]) (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 7786E3A0DC9 for <netmod@ietf.org>; Mon, 22 Jun 2020 09:39:06 -0700 (PDT)
ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=jw3d8KQXqAs51HG9O27vsLzvCSFYhVUZhkIQ/GXH66Hqt/ZKWYHCfYesGXErHkncNXuoCwoOWbX/XbJKul636Kwl9q3ZI4+gY0wObK+XTd9+jSnpuLsf8YvYV0A6WtA83f7zaiWyG5Du5ry8x+qni9gDYU8knnqfMLsOaLelJlI9xlafPfaaVUb3cm2GOXOWFgmYY8nVo0MZSTvoKLTltwM9g30i4wpIwyx/TzbB96EQPCQgHdwD4YiXsIZZEx1ONojrMx8m6kwlNHIRP9O19Rlvni0HbzzAlth7FS6mCiAif6UCznVuRqf31/+pkzuBR/JMp/kdod4v12D9w9jiNw==
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=vszxAijnh/RkK9unWhI8pMiuMsQNpJNSZJA8G+zkdj4=; b=KwrGc0ZujucDd50zPSJyTFuizskIJABsCbG6j9xgLHsK1ERpd8PN0zEYLu3RDIvX9le6PXCQZwI1XozlmZpfqPSOLgS2OpAB/rxJxSDe4uYG3DQWWGGE+1ixiaigx5F8Xw6z7wUSyQnMm+A03zP3x42Zjij9pL+lS63WCB2LnAoeLym3yBAB2KS4R/mT/sMlhziX2KmJbYKqVvBUDHyRtmtjHIGoMEPOf6kCExCiqRkqcdq2NlFwyd7ZeYgn3ZST3RwxeaMqlYMFwtzBaVcZnX1yVDZ+oCE+xyPy5jfuO49c7Btd2Fy6Xl5SXODQmOBq+cKHep+bC7JwPEbzjPR26Q==
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=vszxAijnh/RkK9unWhI8pMiuMsQNpJNSZJA8G+zkdj4=; b=XBu9D0VOoKpIgMi14fOl9z0GxpwaH0oNlrH2n/aG87F9teZBLDIYwrHtIPb72J5QUKJsHNomTyS+9qNOY6MPRULc3x0wF4TG8lQWjcUc3JzfXA2Au0qqk+WQ0rr+kQv+ueedBeeo2RlFu+NFzwgkBEvz1hTO8iOatv4xZ3LyIx0=
Received: from DM5PR08MB2633.namprd08.prod.outlook.com (2603:10b6:3:ca::21) by DM6PR08MB3961.namprd08.prod.outlook.com (2603:10b6:5:89::23) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3109.22; Mon, 22 Jun 2020 16:39:04 +0000
Received: from DM5PR08MB2633.namprd08.prod.outlook.com ([fe80::b02f:de62:22d1:444f]) by DM5PR08MB2633.namprd08.prod.outlook.com ([fe80::b02f:de62:22d1:444f%8]) with mapi id 15.20.3109.027; Mon, 22 Jun 2020 16:39:04 +0000
From: "Sterne, Jason (Nokia - CA/Ottawa)" <jason.sterne@nokia.com>
To: Juergen Schoenwaelder <j.schoenwaelder@jacobs-university.de>
CC: "netmod@ietf.org" <netmod@ietf.org>
Thread-Topic: [netmod] module-versioning should require any solution to describe labels for drafts
Thread-Index: AdZIqTodlifsCupDS9O8VkBxipyRrQAAl3UAAACBCyAAAS6lgAAAOdyQ
Date: Mon, 22 Jun 2020 16:39:04 +0000
Message-ID: <DM5PR08MB26335E775B54D32586423FC29B970@DM5PR08MB2633.namprd08.prod.outlook.com>
References: <DM5PR08MB2633618B426287D32C6D5D219B970@DM5PR08MB2633.namprd08.prod.outlook.com> <20200622154128.rn5v2u4kci2icdga@anna.jacobs.jacobs-university.de> <DM5PR08MB26334DF9A18C827B6A9E8D999B970@DM5PR08MB2633.namprd08.prod.outlook.com> <20200622162945.hbbwnqyiwjsb7hhy@anna.jacobs.jacobs-university.de>
In-Reply-To: <20200622162945.hbbwnqyiwjsb7hhy@anna.jacobs.jacobs-university.de>
Accept-Language: en-US
Content-Language: en-US
X-MS-Has-Attach:
X-MS-TNEF-Correlator:
authentication-results: jacobs-university.de; dkim=none (message not signed) header.d=none;jacobs-university.de; dmarc=none action=none header.from=nokia.com;
x-originating-ip: [24.226.236.156]
x-ms-publictraffictype: Email
x-ms-office365-filtering-ht: Tenant
x-ms-office365-filtering-correlation-id: e8081b2a-6373-4685-db92-08d816cac6cd
x-ms-traffictypediagnostic: DM6PR08MB3961:
x-microsoft-antispam-prvs: <DM6PR08MB3961CB421A0229ABB6EA8D2A9B970@DM6PR08MB3961.namprd08.prod.outlook.com>
x-ms-oob-tlc-oobclassifiers: OLM:10000;
x-forefront-prvs: 0442E569BC
x-ms-exchange-senderadcheck: 1
x-microsoft-antispam: BCL:0;
x-microsoft-antispam-message-info: NFzKYW9GeLNjLsamZHHQpymMi0YLpi01eH/SSYCHulRBOlUA9SD2jMXetRkerUEJ6Qd2mXzZtH3vPBaT2/mJg3PFgXtGl7NM4psL43R53HpqDEwLCknmi6HsgrykR8i774KMlr2yzwzGALF8CBVk7Un5eaIWLYPWTJV/BLBsmrq/jSGw5FBUePV+A8z8khUCa/nXLp3RFuVp0Mx3V15sNlS9tWA2LMEXFrKxxzGeQzvulK/hA5B5NDhaExQsAgdTA1ljuXTkCl8vlERDpYN+ZRj5uI0llv3lzyPT/UuzmmjqQpbhfuFuD/xTFpDg9ctthYPPr5C4rYGt+QirTT4BMnu1gny/wZCliL9EyxnVXp/aohCYiRz/MhB1yjRJX5xZmxLSQ0ywo5uN/PDKyLkIPA==
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:(4636009)(396003)(136003)(39860400002)(376002)(346002)(366004)(52536014)(6506007)(53546011)(6916009)(83380400001)(86362001)(186003)(5660300002)(26005)(83080400001)(66946007)(76116006)(66476007)(64756008)(66556008)(478600001)(2906002)(66446008)(33656002)(7696005)(4326008)(55016002)(8936002)(71200400001)(9686003)(316002)(8676002); DIR:OUT; SFP:1102;
x-ms-exchange-antispam-messagedata: 2dslG4ueCEVnETZQRLuW8zWdopDTjMhIN53S9C/sejaWFdBkBu5ca70fgB0nQlhEzBGeeR9IGfUdVgiyUn5oOzxdTzivlYxxihI46qSB4CtSr2GYi/0pV2tPyR3IhGPbZ0rKiZNRmonC59qSdp1NDIlKEfPsNFAElq7VY9WtR9094X6II2X8RaDcPQX1eY+ChcEHbGQ2ivaQT/rB3wrKs2R+wOiIiPxMWSq/fPuKFDrfZLeZbfw2pkpM9vwRBzYAsajZOLPSvWSlSW2BfgHfVqP+kIihpCTWodeLOyMIHgVxO8FJsfq0cE6cK//p0DtNeepi2s4UTN1635ie6Lu8IGvz6/THPk2S6Vs/tBusgPJJTOjjjJfZyQPlpVc8FoEgvfF/sB2T/+tPyjQ6TDP+dASFiVjoqL43altYWT1PWZWyvnmwCjBSwE9cqetOK8pQk+IvU4aYIuvsTpG1xeJwmMmuJ5dvRmyEthnz9dlCeqU7GmWRKEGTCJXQtpuk+8wW
x-ms-exchange-transport-forked: True
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: base64
MIME-Version: 1.0
X-OriginatorOrg: nokia.com
X-MS-Exchange-CrossTenant-Network-Message-Id: e8081b2a-6373-4685-db92-08d816cac6cd
X-MS-Exchange-CrossTenant-originalarrivaltime: 22 Jun 2020 16:39:04.6180 (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: 5rpwlDyEMLT7O250cFAgfJL/p4fDzf7n0CYdXOtbmTTBRDKMPNsEaCXy+4p6NY7QY40nLOiA/oq4NK/bmLm/uw==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM6PR08MB3961
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/ymGzI1_kw9mQY1kZ__otNRKBtdg>
Subject: Re: [netmod] module-versioning should require any solution to describe labels for drafts
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, 22 Jun 2020 16:39:10 -0000

Sorry - I messed that up with my copy-n-pasting and editing.  Let me try that again 😊

I have RFCXXXX at version 1.0.0.
1.0.0

 I make some backwards compatible changes. 
1.1.0-XXXXbis-dev1

I then make a backwards incompatible change. 
2.0.0-XXXXbis-dev2

Then I add more backwards compatible changes. 
2.0.0-XXXXbis-dev3

Then I remove the backwards incompatible change. 
1.1.0-XXXXbis-dev4

Then if we published the RFC at that point it would be 1.1.0

Jason


> -----Original Message-----
> From: Juergen Schoenwaelder <j.schoenwaelder@jacobs-university.de>
> Sent: Monday, June 22, 2020 12:30 PM
> To: Sterne, Jason (Nokia - CA/Ottawa) <jason.sterne@nokia.com>
> Cc: netmod@ietf.org
> Subject: Re: [netmod] module-versioning should require any solution to describe
> labels for drafts
> 
> On Mon, Jun 22, 2020 at 04:01:59PM +0000, Sterne, Jason (Nokia - CA/Ottawa)
> wrote:
> > Hi Juergen,
> >
> > Section 5 in the link below attempts to explain how to manage this (but always
> happy for review of that text to help improve it).
> >
> > The key is to always ensure there is a unique version for every revision that
> exists.
> >
> > In your example below it would go like this:
> >
> > I have RFCXXXX at version 1.0.0. I make some backwards compatible changes:
> > 1.0.0
> 
> I use the same version number until I make an incompatible change?
> 
> > I then make a backwards incompatible change:
> > 1.1.0-XXXXbis-dev1
> >
> > Then I add more backwards compatible changes:
> > 2.0.0-XXXXbis-dev2
> >
> > Then I remove the backwards incompatible change:
> > 1.1.0-XXXXbis-dev3
> >
> > When the module is finally published as an RFC it would just be version 1.1.0 in
> this case.
> >
> > The main problems covered:
> > - ensure all intermediate versions have a unique identifier (in case there are
> pre-release implementations, etc)
> > - ensure the final version has the correct YANG Semver
> >
> 
> /js
> 
> --
> Juergen Schoenwaelder           Jacobs University Bremen gGmbH
> Phone: +49 421 200 3587         Campus Ring 1 | 28759 Bremen | Germany
> Fax:   +49 421 200 3103         <https://www.jacobs-university.de/>

v2.23.0 | Report a Bug | By Email