Re: [netmod] versioning procedures (RFC vs. I-D)

"Joe Clarke (jclarke)" <jclarke@cisco.com> Thu, 02 April 2020 16:42 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 0C3BC3A07B9 for <netmod@ietfa.amsl.com>; Thu, 2 Apr 2020 09:42:07 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -9.599
X-Spam-Level:
X-Spam-Status: No, score=-9.599 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, HTML_MESSAGE=0.001, 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=kDWNobO1; dkim=pass (1024-bit key) header.d=cisco.onmicrosoft.com header.b=Qi/9NBPm
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 oUDxNCQw5E2e for <netmod@ietfa.amsl.com>; Thu, 2 Apr 2020 09:42:05 -0700 (PDT)
Received: from rcdn-iport-1.cisco.com (rcdn-iport-1.cisco.com [173.37.86.72]) (using TLSv1.2 with cipher DHE-RSA-SEED-SHA (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id CD1673A079C for <netmod@ietf.org>; Thu, 2 Apr 2020 09:42:04 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=cisco.com; i=@cisco.com; l=5383; q=dns/txt; s=iport; t=1585845724; x=1587055324; h=from:to:cc:subject:date:message-id:references: in-reply-to:mime-version; bh=FMG+HYbf5EOtyR5MoTYEptN8OH1S5gy8vLBWckA2aUw=; b=kDWNobO10xyR0XaSuCbdxfj8EJ1sdagtgZ5NnFe0/2t3TI9kcbO7oZxO wQjPS3+bPvZjn1psqjYVaZCdWcrWtjFsZm27Iysb+caX2+jJf24rCsJVr sV9IWCFiOcJpUDNppNYHenBA3Yc/fvSZ8+fFJOBPZ0DpHvwxzDpDse+05 8=;
IronPort-PHdr: =?us-ascii?q?9a23=3AIcdI+hyoOVyYpo3XCy+N+z0EezQntrPoPwUc9p?= =?us-ascii?q?sgjfdUf7+++4j5YhSN/u1j2VnOW4iTq+lJjebbqejBYSQB+t7A1RJKa5lQT1?= =?us-ascii?q?kAgMQSkRYnBZuHAknyNv3nRyc7B89FElRi+iLzPA=3D=3D?=
X-IronPort-Anti-Spam-Filtered: true
X-IronPort-Anti-Spam-Result: =?us-ascii?q?A0D/BwDDFIZe/40NJK1mHgELHIFwC4F?= =?us-ascii?q?UUAWBRCAECyqHYAOKaJYchGGBLoEkA1QKAQEBDAEBLQIEAQGERAKCQSQ2Bw4?= =?us-ascii?q?CAwEBCwEBBQEBAQIBBQRthVYMhXECAQMSLgEBNwEPAgEIPwcyFBECBA4FIoM?= =?us-ascii?q?EgX9NAy4BpHcCgTmIYoIngn8BAQWFKRiCDAmBOIwxGoFBP4E4IIJNPogSgiy?= =?us-ascii?q?OBzOIRZoHCoI9lxsdm3KoCYM2AgQCBAUCDgEBBYFZAjAqgS1wFWUBgj4+Ehg?= =?us-ascii?q?Njh2Dc4pVdIEpjh4BAQ?=
X-IronPort-AV: E=Sophos;i="5.72,336,1580774400"; d="scan'208,217";a="741181398"
Received: from alln-core-8.cisco.com ([173.36.13.141]) by rcdn-iport-1.cisco.com with ESMTP/TLS/DHE-RSA-SEED-SHA; 02 Apr 2020 16:42:03 +0000
Received: from XCH-RCD-005.cisco.com (xch-rcd-005.cisco.com [173.37.102.15]) by alln-core-8.cisco.com (8.15.2/8.15.2) with ESMTPS id 032Gg32j020653 (version=TLSv1.2 cipher=AES256-SHA bits=256 verify=FAIL); Thu, 2 Apr 2020 16:42:03 GMT
Received: from xhs-rtp-002.cisco.com (64.101.210.229) by XCH-RCD-005.cisco.com (173.37.102.15) with Microsoft SMTP Server (TLS) id 15.0.1497.2; Thu, 2 Apr 2020 11:42:03 -0500
Received: from xhs-aln-003.cisco.com (173.37.135.120) by xhs-rtp-002.cisco.com (64.101.210.229) with Microsoft SMTP Server (TLS) id 15.0.1497.2; Thu, 2 Apr 2020 12:42:02 -0400
Received: from NAM11-BN8-obe.outbound.protection.outlook.com (173.37.151.57) by xhs-aln-003.cisco.com (173.37.135.120) with Microsoft SMTP Server (TLS) id 15.0.1497.2 via Frontend Transport; Thu, 2 Apr 2020 11:42:02 -0500
ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=BLnGcTSGAh63INfH6EKGR88EnRB4FEJw6HKOtVdqifV8SmAu1LWSlbKdP8N41IPVLfBzlKBc5XZpqtCniYuSFem8RRtMHKw4KI/24GqkMnrk3/cJ/kj4mnlqJnfQgVBl8B3W8RjLyLsovKtWfjPsx8IwpNJs81OulxAGpUVjv/Re8k+tBmy70s6f9BXZc3J9GMjH98t463DPuvS+FALl/F3gcehI/uPsAGs40X0dt54cnHBaTd1+t57LTSSs+rFFVzqohuKnpxgDrD3kdqfZljEoJAS7zoI6/tg1vonbVT9wYMjfiTDvRVPMfQ984Xwj2YRcNRVoGxpYUtgMRAO5tQ==
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=tRCX85RSOuL3z9MBVnzoHtskLNB+xXFinN/bb+YmSMw=; b=HoBFfqdHcKEkr7enZX+7Yjf7RSmgUt2ECU9qB5KsoJqKof9zx2xXI62fOZeCmVF3ibjXn5zxOB9T5AfxpLj+1CpzJ+bZf7I4dkSE8Zn60Dp2Iq/lEmSnvD108csBui35mAiMnXGwTTb6701bo7Ft0pLypMrWiBlYWG1AyKrlS39Xjje0xocSv0QDNlZhs05vA6Nq5j0g4HX60yfaSy3HkP+pbTpIkLt5LZk6K0rym60otTBmrntXn+7JMguA6c2eegAgkSvnoYMCSMFqo9x9hfAtGle20baqsqeUQApT7HQci+2UDc077g0HtHegP617QN2oebATcrxyQeTKDe6QSQ==
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=tRCX85RSOuL3z9MBVnzoHtskLNB+xXFinN/bb+YmSMw=; b=Qi/9NBPmCmMeYmZPIIZVEWgcOkQ9ivhpjCQ+5WYzlaIwa9M0ATDNdhibG+twXyHPvVi+unz2y2wl7++UwjhWZllb8OLhDBjZb3ijysiZbdqmvpA06I2/br5V+iq8WTj0lY1fcVxK1Yc1I8/yEpP28sb5ZXki2NOZlWE60+/UWvc=
Received: from BN6PR11MB1667.namprd11.prod.outlook.com (2603:10b6:405:e::12) by BN6PR11MB3986.namprd11.prod.outlook.com (2603:10b6:405:77::32) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.2878.16; Thu, 2 Apr 2020 16:41:57 +0000
Received: from BN6PR11MB1667.namprd11.prod.outlook.com ([fe80::9dc8:a67:89cd:a2d2]) by BN6PR11MB1667.namprd11.prod.outlook.com ([fe80::9dc8:a67:89cd:a2d2%12]) with mapi id 15.20.2878.017; Thu, 2 Apr 2020 16:41:57 +0000
From: "Joe Clarke (jclarke)" <jclarke@cisco.com>
To: Andy Bierman <andy@yumaworks.com>
CC: "Reshad Rahman (rrahman)" <rrahman@cisco.com>, Italo Busi <Italo.Busi@huawei.com>, NetMod WG <netmod@ietf.org>
Thread-Topic: [netmod] versioning procedures (RFC vs. I-D)
Thread-Index: AQHWCEsdd6R2TKdx5EuH2TUi1UnWsqhkiBAAgAAIEoCAAAHBAIAA+WyAgAAjEgCAADZOAIAABbEAgAAU/ICAAAtLAA==
Date: Thu, 2 Apr 2020 16:41:56 +0000
Message-ID: <0383A6F8-27CB-4A76-8B2A-47F229F01025@cisco.com>
References: <CABCOCHQWssUucRvnsi8O8+GhCHb0-xS--swf3R4q-6P3Qfq0TA@mail.gmail.com> <D63416FC-2C33-4015-BF23-51ABCD75A020@cisco.com> <CABCOCHSTnYJbB9ainkmCuBinjRZAi-wEWgQoFCrhs+m8NBAAYQ@mail.gmail.com> <50052092-0380-44C6-8AE0-1AB3C15C30B4@cisco.com> <b688d8372a1a49e8828c74b5366458c0@huawei.com> <1DE96CAC-43BC-4638-AE96-2E770CA7CE20@cisco.com> <CABCOCHRDKKmU1+BL_4RPkn4sMhjN8w20_5rHWOoBCm8PCTTi1Q@mail.gmail.com> <B9DDE091-36C7-4E83-B20C-352E3C111151@cisco.com> <CABCOCHQYhqt3Zt80-BOvMh2yTpStMxXKYKQbq+mmEJMmHoMcLg@mail.gmail.com>
In-Reply-To: <CABCOCHQYhqt3Zt80-BOvMh2yTpStMxXKYKQbq+mmEJMmHoMcLg@mail.gmail.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: spf=none (sender IP is ) smtp.mailfrom=jclarke@cisco.com;
x-originating-ip: [2600:1700:b00:b239:f972:a5af:d67:bf9f]
x-ms-publictraffictype: Email
x-ms-office365-filtering-correlation-id: dc961d8f-9a95-4c69-5e0b-08d7d724c212
x-ms-traffictypediagnostic: BN6PR11MB3986:
x-ms-exchange-transport-forked: True
x-microsoft-antispam-prvs: <BN6PR11MB39868F7E11BCC38DD07C865CB8C60@BN6PR11MB3986.namprd11.prod.outlook.com>
x-ms-oob-tlc-oobclassifiers: OLM:9508;
x-forefront-prvs: 0361212EA8
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:(10009020)(4636009)(396003)(346002)(366004)(376002)(136003)(39860400002)(36756003)(5660300002)(33656002)(6916009)(2616005)(86362001)(8936002)(2906002)(478600001)(71200400001)(54906003)(6486002)(6512007)(4326008)(76116006)(8676002)(66446008)(91956017)(66476007)(66556008)(64756008)(6506007)(53546011)(81156014)(81166006)(66946007)(316002)(186003); DIR:OUT; SFP:1101;
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: rnKEkccDCCIL3h27v0VBxNuIq8Q3NUF9RxiBKL3tqkZe5f8CpNx+ZCWf2nQg7wzi51B3W7NBS2LyymUQCBRPAiyaHnZZ5ZgOD4vhuz+K94zIoqETSmWd32SjENVKqOfXyXx9XKCtZ4oi4HZXNBZe+3pVNULuQVmV0OlJ4pGDmGIFXhBgOMl1hJPgCvLhyJQRwqYPZxnxQ5LILm9RueNcYriNDcmOdj72AK9uKM/mZ2gAKHX+0PCEu9tItCD3uN8AsQKK4xoLtTubkeVdVogWxQn6BILGaJwqEVlQzfBjIzYBVOCS8U0wKM+/ZOoisgCO6gNZhFMUownVpmDsQr8rspe5X1sduQ6Y+fm3g/jj2B4VFsSS+dcFvUNsdx05BNU1wITzEJn0em8wm6XWcRoeMBAzmQNyAarraz4oLQVk+UnJ6092uyNT00KXs7OTmWIW
x-ms-exchange-antispam-messagedata: 9iPHcmw+rdW3Qqshwg9G3PDfo2pYEMKDtxOeEk2x07w/atLbrIX+06qwyQwGDupOCyT/bUJ1Cf1O1xPxVhId6ipFTfYFgR++cGB9R186/nvdqaoH7yKaHXCW/pCh5KfNxSLjJf5Q6cxtu5Ao+p0cU/OqwNBoKZ0CuGPctxMt57zki1GKWibnUGdcpwt5iTLPf9CGGrrpNDLoxQPGcUtyHQ==
Content-Type: multipart/alternative; boundary="_000_0383A6F827CB4A768B2A47F229F01025ciscocom_"
MIME-Version: 1.0
X-MS-Exchange-CrossTenant-Network-Message-Id: dc961d8f-9a95-4c69-5e0b-08d7d724c212
X-MS-Exchange-CrossTenant-originalarrivaltime: 02 Apr 2020 16:41:56.9813 (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: jUj9j2vyDNfKlCpDPQjtQpj8ggJGapeIpjo11bCWP66nc6Qu9tTG77TUYjyjqZRFvPdLS13ZU7m2gHjbxscOMQ==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: BN6PR11MB3986
X-OriginatorOrg: cisco.com
X-Outbound-SMTP-Client: 173.37.102.15, xch-rcd-005.cisco.com
X-Outbound-Node: alln-core-8.cisco.com
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/6ht_KK7_4dfLpShQHTfH4aK5k_4>
Subject: Re: [netmod] versioning procedures (RFC vs. I-D)
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: Thu, 02 Apr 2020 16:42:07 -0000


On Apr 2, 2020, at 12:01, Andy Bierman <andy@yumaworks.com<mailto:andy@yumaworks.com>> wrote:

Hi,

I agree that a revision-label could be useful in an I-D but not to indicate NBC changes (because it doesn't).
The rules need to be clear and simple with no exceptions.

 1) Special version 0.x.y contains NO NBC information
     Major version = 0 means the module has no published version

 2) First published version is 1.0.0

 3) The revision-label in an unpublished module has a special form which simply identifies
      the source of the development and the iteration of the work-in-progress.
      You can't really pick the next published label until the module is ready.

>From my example:

draft-00:   0.1.0
draft-01:   0.2.0
draft-02:   0.3.0
RFC-1:    1.0.0
bis-draft-00:   1.0.0+1
bis-draft-01:   1.0.0+2
bis-draft-02:   1.0.0+3
[repeat NBC step bis-draft-02 10 times]  1.0.0+4 .. 1.0.0+13
RFC-2:  2.0.0   (in general: 1.0.1 or 1.1.0 or 2.0.0)

The BC vs. NBC distinction is not relevant for a work-in-progress.
We have seen many times in this WG where a NBC change was made
and then later undone.  There is no value in tracking the module during development.

I support this scheme.  Rob raised it on the call today as well.  Since YANG semver is a superset of semver 2.0.0, these pre-release and build appendixes will work and could be a way to handle bis drafts well.

Joe