IETF Logo Mail Archive

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

Juergen Schoenwaelder <j.schoenwaelder@jacobs-university.de> Mon, 22 June 2020 16:29 UTC

Return-Path: <j.schoenwaelder@jacobs-university.de>
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 4F72A3A0FAB for <netmod@ietfa.amsl.com>; Mon, 22 Jun 2020 09:29:50 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.899
X-Spam-Level:
X-Spam-Status: No, score=-1.899 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
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 GDMGlcLWIY1t for <netmod@ietfa.amsl.com>; Mon, 22 Jun 2020 09:29:48 -0700 (PDT)
Received: from atlas5.jacobs-university.de (atlas5.jacobs-university.de [212.201.44.20]) (using TLSv1.2 with cipher ADH-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 1F0C33A0F1B for <netmod@ietf.org>; Mon, 22 Jun 2020 09:29:48 -0700 (PDT)
Received: from localhost (demetrius5.irc-it.jacobs-university.de [10.70.0.222]) by atlas5.jacobs-university.de (Postfix) with ESMTP id D40967B8; Mon, 22 Jun 2020 18:29:46 +0200 (CEST)
X-Virus-Scanned: amavisd-new at jacobs-university.de
Received: from atlas5.jacobs-university.de ([10.70.0.198]) by localhost (demetrius5.jacobs-university.de [10.70.0.222]) (amavisd-new, port 10032) with ESMTP id NfZJimV_eFZh; Mon, 22 Jun 2020 18:29:46 +0200 (CEST)
Received: from hermes.jacobs-university.de (hermes.jacobs-university.de [212.201.44.23]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "hermes.jacobs-university.de", Issuer "DFN-Verein Global Issuing CA" (verified OK)) by atlas5.jacobs-university.de (Postfix) with ESMTPS; Mon, 22 Jun 2020 18:29:46 +0200 (CEST)
Received: from localhost (demetrius5.irc-it.jacobs-university.de [10.70.0.222]) by hermes.jacobs-university.de (Postfix) with ESMTP id 8B0DA20154; Mon, 22 Jun 2020 18:29:46 +0200 (CEST)
X-Virus-Scanned: amavisd-new at jacobs-university.de
Received: from hermes.jacobs-university.de ([212.201.44.23]) by localhost (demetrius5.jacobs-university.de [10.70.0.222]) (amavisd-new, port 10028) with ESMTP id EuNl7JrzoPkF; Mon, 22 Jun 2020 18:29:46 +0200 (CEST)
Received: from localhost (anna.jacobs.jacobs-university.de [10.50.218.117]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by hermes.jacobs-university.de (Postfix) with ESMTPS id 3298B200E4; Mon, 22 Jun 2020 18:29:46 +0200 (CEST)
Date: Mon, 22 Jun 2020 18:29:45 +0200
From: Juergen Schoenwaelder <j.schoenwaelder@jacobs-university.de>
To: "Sterne, Jason (Nokia - CA/Ottawa)" <jason.sterne@nokia.com>
Cc: "netmod@ietf.org" <netmod@ietf.org>
Message-ID: <20200622162945.hbbwnqyiwjsb7hhy@anna.jacobs.jacobs-university.de>
Reply-To: Juergen Schoenwaelder <j.schoenwaelder@jacobs-university.de>
Mail-Followup-To: "Sterne, Jason (Nokia - CA/Ottawa)" <jason.sterne@nokia.com>, "netmod@ietf.org" <netmod@ietf.org>
References: <DM5PR08MB2633618B426287D32C6D5D219B970@DM5PR08MB2633.namprd08.prod.outlook.com> <20200622154128.rn5v2u4kci2icdga@anna.jacobs.jacobs-university.de> <DM5PR08MB26334DF9A18C827B6A9E8D999B970@DM5PR08MB2633.namprd08.prod.outlook.com>
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-Disposition: inline
In-Reply-To: <DM5PR08MB26334DF9A18C827B6A9E8D999B970@DM5PR08MB2633.namprd08.prod.outlook.com>
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/uCDnvLdVJfzJrxYRKC0YV0xxXwA>
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:29:56 -0000

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