Re: [netmod] [yang-doctors] Yangdoctors last call review of draft-ietf-netmod-nmda-diff-04
Alexander Clemm <alex@futurewei.com> Fri, 25 September 2020 19:31 UTC
Return-Path: <alex@futurewei.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 797843A0774; Fri, 25 Sep 2020 12:31:08 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -0.543
X-Spam-Level:
X-Spam-Status: No, score=-0.543 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, HTTPS_HTTP_MISMATCH=0.1, LH_URI_DOM_IN_PATH=1.446, RCVD_IN_MSPIKE_H2=-0.001, T_SPF_PERMERROR=0.01, URIBL_BLOCKED=0.001] autolearn=no autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=futurewei.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 iGTI_-fUj-AK; Fri, 25 Sep 2020 12:31:05 -0700 (PDT)
Received: from NAM12-DM6-obe.outbound.protection.outlook.com (mail-dm6nam12on2124.outbound.protection.outlook.com [40.107.243.124]) (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 3FA9F3A0763; Fri, 25 Sep 2020 12:31:04 -0700 (PDT)
ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=Y1vAQw955YtGVyAPSsgGi1ze1p6aU5Aw58FzkaZpNAtUpa1fQbCxEsSFwvsGqPPxsKXjpLlukLFRsYTn0BtYRwyrYxOwjqBpNOwprZtNw4edmDmXnOQ0Dofqhd+YeJHf+IW3i2/94VzfisqW/FHL7M4u1VDHRNfgO9RfQWn9VtGJykzbRU+DqyaYhV6osCZtQaH1DRlQT9cIvVVzh/aUEWppljvOpBJqcjl0YU+XeDuFtMey3YB1OUsa2UaCGL4kIiFATJ7hsdYlErwrCyltvc2iKKokhgyFju62awNY7/hx8RvXKkWXD1CvVm4umlLQkZ3AMeNoERBw0+DECdawIQ==
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=QCBy2aUPTDgff5+cmtqxbJy1wgn9oRKJm/jHWVaL0m4=; b=cn11TG8m4vUxAOxXsblH3WX7XfzYKPhZsdB36p8VCMEtauf+YHnWUNZ9ZA1f85CVNiK6tFflwSj0bzAucbRwtvwW9fWSDRCtHymprhOiXLxfppf7iDdo4pkGH3l1QHGENGgqmtcHzCzahluUGFgShzXbL2vSoHsWHN8cTHTQuPxMRzuzp3cfij4tQDXviH0vnSjubYbLpxymkR4AkV0IFTzvYkv3mmFwWZwWfmwZs7eUJkIeHYNgcDLKtdyt8Bcc3YgoHIUMDXj8ySHu2dXlPZKcRYKkVWSv6fc1Juuy5fSkeT+5A5MqU7I9UllQIqpLbVvkKHAaTHctGQx38AtopQ==
ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=futurewei.com; dmarc=pass action=none header.from=futurewei.com; dkim=pass header.d=futurewei.com; arc=none
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=Futurewei.com; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=QCBy2aUPTDgff5+cmtqxbJy1wgn9oRKJm/jHWVaL0m4=; b=kdOgoAB4kzuCEoJ6UKoNjzHFooJ8mhMyFiSGtsmNRey5Lxk7qW2tYKnGNn8kZL4jg/XMNuyhdDil+WRqrgUQKPg6Qw0js2ES5ZEv2tHbSS3/dsgYslRkc8pjcJQdtMkvu0F1ML1IZnEgmLGqRfLKKlXW6tyzSPuSgyON0CmS6CY=
Received: from BY5PR13MB3793.namprd13.prod.outlook.com (2603:10b6:a03:226::15) by BY5PR13MB3126.namprd13.prod.outlook.com (2603:10b6:a03:189::17) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3412.11; Fri, 25 Sep 2020 19:30:57 +0000
Received: from BY5PR13MB3793.namprd13.prod.outlook.com ([fe80::f0f3:2a3f:eaf2:6f26]) by BY5PR13MB3793.namprd13.prod.outlook.com ([fe80::f0f3:2a3f:eaf2:6f26%5]) with mapi id 15.20.3433.018; Fri, 25 Sep 2020 19:30:57 +0000
From: Alexander Clemm <alex@futurewei.com>
To: "Reshad Rahman (rrahman)" <rrahman=40cisco.com@dmarc.ietf.org>, Yingzhen Qu <yingzhen.qu@futurewei.com>, Alexander L Clemm <ludwig@clemm.org>, "yang-doctors@ietf.org" <yang-doctors@ietf.org>
CC: "last-call@ietf.org" <last-call@ietf.org>, "draft-ietf-netmod-nmda-diff.all@ietf.org" <draft-ietf-netmod-nmda-diff.all@ietf.org>, "netmod@ietf.org" <netmod@ietf.org>
Thread-Topic: [netmod] [yang-doctors] Yangdoctors last call review of draft-ietf-netmod-nmda-diff-04
Thread-Index: AQHWhSBGCXBiS51HK0yXciHkszIEsKlqQVkAgAAdZoCAAAeMAIAEBfmAgABxJoCAAAGEgIAAAEGAgAXZRgCABDDYAIAAcsaAgAAvEwCAAA0yAIAABDoAgAAO1gCAAC78UA==
Date: Fri, 25 Sep 2020 19:30:57 +0000
Message-ID: <BY5PR13MB3793893AFA40E42D49CCDEE5DB360@BY5PR13MB3793.namprd13.prod.outlook.com>
References: <159942490640.25028.10946254095755778899@ietfa.amsl.com> <EF21460A-8689-491C-AE19-942C6FA84FFC@cisco.com> <e801c95e-078e-8438-b1a0-18aaf4be3a82@clemm.org> <8759A9BF-300C-46F7-B39F-9EF4CFA2D726@cisco.com> <22126972-0920-1bb3-a73f-f4a219a59bf6@clemm.org> <0E3A16A2-6ABA-4868-936F-AA6C9AAF3A8E@cisco.com> <7cf5120e-28c9-383a-5238-0d6749e93854@clemm.org> <100F7855-CFE2-4E04-927F-A25089D3B2BA@cisco.com> <1b722d38-af72-a96b-9368-49d678a1151a@clemm.org> <246871E9-491C-4F51-85BE-31645204E89B@cisco.com> <AEE35B9D-3009-473F-BB93-B5BD9E753B1A@futurewei.com> <A5877C6F-1B9A-4E91-93CA-7B692F599CCD@cisco.com> <6803F3F2-BA10-45A3-8709-672C9F047F8B@futurewei.com> <9BE49824-8836-41AB-97E7-A72DDE649901@cisco.com> <84B5AA48-3353-45FF-9D95-23F21B4A2EFE@futurewei.com> <D36DD1F1-18AD-4668-83F1-595ADE035E16@cisco.com>
In-Reply-To: <D36DD1F1-18AD-4668-83F1-595ADE035E16@cisco.com>
Accept-Language: en-US
Content-Language: en-US
X-MS-Has-Attach:
X-MS-TNEF-Correlator:
authentication-results: dmarc.ietf.org; dkim=none (message not signed) header.d=none;dmarc.ietf.org; dmarc=none action=none header.from=futurewei.com;
x-originating-ip: [73.189.160.186]
x-ms-publictraffictype: Email
x-ms-office365-filtering-correlation-id: 211232d8-3caf-44c2-5256-08d8618986b6
x-ms-traffictypediagnostic: BY5PR13MB3126:
x-ms-exchange-transport-forked: True
x-microsoft-antispam-prvs: <BY5PR13MB312613E7D5FC6A4EC96015FBDB360@BY5PR13MB3126.namprd13.prod.outlook.com>
x-ms-oob-tlc-oobclassifiers: OLM:10000;
x-ms-exchange-senderadcheck: 1
x-microsoft-antispam: BCL:0;
x-microsoft-antispam-message-info: BKovW3Of7eu/tYOIiTh1pHRgR7upRFqDQOf1H6iMEpAv9P8zyuBE8CLf/ul8p1qxCUPhixMcBDTKJNpc69YN1bONA5QpweN8egyNsHZNitZzWHeUlDqtq/KFs93e8TTjWHMQaAhX96TSqHgkvxyWRBE7lIMK/3g73eJLsG3mHwZvo21LvMPhldlryxLfLlia38FHW7nwyEDDRAj+C+aMUFuY6uEAPUSHpBGRdEZ7wdJDc7OI9XaOWiwYO4mTzdnBxXF1G3vq/CLFz4bksedL/R0Az4qbC8LUc+5MrGiO4Qs6a+nWXIuAEkG5cGtj619u/Jyk5Vk8BXZL8JUrdwsTHfK7unCEetlRqjKCSmOVzxSejsqAE90mnIRD6Fu/Cwqh9sFJaOWjQxW1LRXq7OPXZrwa1bjg2ubChcVw4vGhI2Ax2LjnrdXvk9m012d+sKkYYfDApfg3v3TW0vCUVtPu6A==
x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:BY5PR13MB3793.namprd13.prod.outlook.com; PTR:; CAT:NONE; SFS:(4636009)(136003)(376002)(396003)(366004)(39840400004)(346002)(9686003)(30864003)(53546011)(86362001)(478600001)(6506007)(186003)(26005)(55016002)(110136005)(5660300002)(2906002)(52536014)(7696005)(966005)(316002)(8936002)(33656002)(4326008)(83380400001)(66556008)(8676002)(66446008)(64756008)(71200400001)(66476007)(66946007)(76116006)(166002)(54906003)(559001)(579004); DIR:OUT; SFP:1102;
x-ms-exchange-antispam-messagedata: Ws7qgPItvb6h8OXZl8P+3z/KxapLdCrbRwWu9VFSlJyC6E1CB1SpLTyAZv9XRM6Fe1doDexMLUSWig5GsCnd6LzroBD9iUJy6saVsE+wkfChBptMDbU8O4NLn5CdulvN6zadSnhbWtPGL2fu1WnqQXPrl++n/YBZkliyHzXqXamm6pKW6NXwFHy4SlUpsnYCEUwPV6oOPkJ0Tz7HJiB5kSYpz7EiLRPNNNplRcqErwHla0wTXPNmFyo0eH31l6bBbia+Ek/BpE+MziO+wYMjNtW5y8bmp567w/EnHu2dNTJYjPDJ4cOcWzXAWrUK5YTPbMgU+w1PswAqRNn/uR3LM+o7hYPpCiv0zhC3Jcxip6bp4rPQEwQ5a/oi7rdSHFddFs0cqA+pjhqyDyXVZ53ioudCd8fkwValtaFtNfycvp31Nu+KsOKxRAohh4Bip1/j5n+nTQAX7Dx+Jk7RsGSV83EC9WrqilGOFqt5wj9lfsnpO4p2V3zqWCKMiPOG1rQVo5dg4vrNts2srZHK7ZNb8oosXehw4qTzvWYAVwCBZ6Xdzv09reOczy3ycaqvttZobScw8Og080saRpqDpiJH0xc2+E0fRZi6LiujNGFLpL3/w4YGzhbP82K5pfwNbLzchi/PniwenYeDLI5rvEcpeA==
Content-Type: multipart/alternative; boundary="_000_BY5PR13MB3793893AFA40E42D49CCDEE5DB360BY5PR13MB3793namp_"
MIME-Version: 1.0
X-OriginatorOrg: Futurewei.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-AuthSource: BY5PR13MB3793.namprd13.prod.outlook.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 211232d8-3caf-44c2-5256-08d8618986b6
X-MS-Exchange-CrossTenant-originalarrivaltime: 25 Sep 2020 19:30:57.0219 (UTC)
X-MS-Exchange-CrossTenant-fromentityheader: Hosted
X-MS-Exchange-CrossTenant-id: 0fee8ff2-a3b2-4018-9c75-3a1d5591fedc
X-MS-Exchange-CrossTenant-mailboxtype: HOSTED
X-MS-Exchange-CrossTenant-userprincipalname: p8mKmIHlhbcqvxd6max7TPhUj/7O4LdSW2r7dSNT3NBIHr8f5mTB+w17k0n7t/3oKmr0lRQc0xeF6cDbUleT6w==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: BY5PR13MB3126
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/0qABkc_USWbDYMqBq84r8Ud6WE0>
Subject: Re: [netmod] [yang-doctors] Yangdoctors last call review of draft-ietf-netmod-nmda-diff-04
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: Fri, 25 Sep 2020 19:31:09 -0000
Thanks, Reshad and Yingzhen! --- Alex From: netmod <netmod-bounces@ietf.org> On Behalf Of Reshad Rahman (rrahman) Sent: Friday, September 25, 2020 9:42 AM To: Yingzhen Qu <yingzhen.qu@futurewei.com>; Alexander L Clemm <ludwig@clemm.org>; yang-doctors@ietf.org Cc: last-call@ietf.org; draft-ietf-netmod-nmda-diff.all@ietf.org; netmod@ietf.org Subject: Re: [netmod] [yang-doctors] Yangdoctors last call review of draft-ietf-netmod-nmda-diff-04 Looks good, no new issues. Regards, Reshad. From: Yingzhen Qu <yingzhen.qu@futurewei.com<mailto:yingzhen.qu@futurewei.com>> Date: Friday, September 25, 2020 at 11:49 AM To: "Reshad Rahman (rrahman)" <rrahman@cisco.com<mailto:rrahman@cisco.com>>, Alexander L Clemm <ludwig@clemm.org<mailto:ludwig@clemm.org>>, "yang-doctors@ietf.org<mailto:yang-doctors@ietf.org>" <yang-doctors@ietf.org<mailto:yang-doctors@ietf.org>> Cc: "last-call@ietf.org<mailto:last-call@ietf.org>" <last-call@ietf.org<mailto:last-call@ietf.org>>, "netmod@ietf.org<mailto:netmod@ietf.org>" <netmod@ietf.org<mailto:netmod@ietf.org>>, "draft-ietf-netmod-nmda-diff.all@ietf.org<mailto:draft-ietf-netmod-nmda-diff.all@ietf.org>" <draft-ietf-netmod-nmda-diff.all@ietf.org<mailto:draft-ietf-netmod-nmda-diff.all@ietf.org>> Subject: Re: [yang-doctors] [netmod] Yangdoctors last call review of draft-ietf-netmod-nmda-diff-04 Hi Reshad, Thanks for the link to verify JSON, it’s very helpful. I’ve uploaded version -07. Please let me know if you have any comments. Thanks, Yingzhen From: "Reshad Rahman (rrahman)" <rrahman@cisco.com<mailto:rrahman@cisco.com>> Date: Friday, September 25, 2020 at 8:34 AM To: Yingzhen Qu <yingzhen.qu@futurewei.com<mailto:yingzhen.qu@futurewei.com>>, Alexander L Clemm <ludwig@clemm.org<mailto:ludwig@clemm.org>>, "yang-doctors@ietf.org<mailto:yang-doctors@ietf.org>" <yang-doctors@ietf.org<mailto:yang-doctors@ietf.org>> Cc: "last-call@ietf.org<mailto:last-call@ietf.org>" <last-call@ietf.org<mailto:last-call@ietf.org>>, "netmod@ietf.org<mailto:netmod@ietf.org>" <netmod@ietf.org<mailto:netmod@ietf.org>>, "draft-ietf-netmod-nmda-diff.all@ietf.org<mailto:draft-ietf-netmod-nmda-diff.all@ietf.org>" <draft-ietf-netmod-nmda-diff.all@ietf.org<mailto:draft-ietf-netmod-nmda-diff.all@ietf.org>> Subject: Re: [yang-doctors] [netmod] Yangdoctors last call review of draft-ietf-netmod-nmda-diff-04 Hi Yingzhen, The JSON example doesn’t seem ok because it only contains 1 edit entry. To confirm I went to https://jsonlint.com/<https://nam11.safelinks.protection.outlook.com/?url=https%3A%2F%2Fjsonlint.com%2F&data=02%7C01%7Calex%40futurewei.com%7C0f32962064e242119f1108d86172362c%7C0fee8ff2a3b240189c753a1d5591fedc%7C1%7C1%7C637366490474870208&sdata=Brd2xHCHKLua5h9xmISxj1uI%2FdzqoI4dlD7bTVtbV1k%3D&reserved=0> and it 1st complained about missing comma after the } for source-value and when I fixed that it complained about Duplicate key ‘edit-id’. FYI, the JSON block below passed the lint check. Regards, Reshad. { "ietf-nmda-compare:output": { "differences": { "ietf-yang-patch:yang-patch": { "patch-id": "interface status", "comment": "diff between intended (source) and operational", "edit": [ { "edit-id": "1", "operation": "replace", "target": "/ietf-interfaces:interface=eth0/enabled", "value": { "ietf-interfaces:interface/enabled": "false" }, "source-value": { "ietf-interfaces:interface/enabled": "true", "@ietf-interfaces:interface/enabled": { "ietf-origin:origin": "ietf-origin:learned" } } }, { "edit-id": "2", "operation": "create", "target": "/ietf-interfaces:interface=eth0/description", "value": { "ietf-interface:interface/description": "ip interface" } } ] } } } } From: Yingzhen Qu <yingzhen.qu@futurewei.com<mailto:yingzhen.qu@futurewei.com>> Date: Friday, September 25, 2020 at 10:47 AM To: "Reshad Rahman (rrahman)" <rrahman@cisco.com<mailto:rrahman@cisco.com>>, Alexander L Clemm <ludwig@clemm.org<mailto:ludwig@clemm.org>>, "yang-doctors@ietf.org<mailto:yang-doctors@ietf.org>" <yang-doctors@ietf.org<mailto:yang-doctors@ietf.org>> Cc: "last-call@ietf.org<mailto:last-call@ietf.org>" <last-call@ietf.org<mailto:last-call@ietf.org>>, "netmod@ietf.org<mailto:netmod@ietf.org>" <netmod@ietf.org<mailto:netmod@ietf.org>>, "draft-ietf-netmod-nmda-diff.all@ietf.org<mailto:draft-ietf-netmod-nmda-diff.all@ietf.org>" <draft-ietf-netmod-nmda-diff.all@ietf.org<mailto:draft-ietf-netmod-nmda-diff.all@ietf.org>> Subject: Re: [yang-doctors] [netmod] Yangdoctors last call review of draft-ietf-netmod-nmda-diff-04 Hi Reshad, Thank you for the example. I modified the XML example as you suggested. The JSON example looks ok to me. Also fixed the nit to reference RFC 6991. New generated txt file attached, please let me know if you see more issues. Thanks, Yingzhen From: "Reshad Rahman (rrahman)" <rrahman@cisco.com<mailto:rrahman@cisco.com>> Date: Friday, September 25, 2020 at 4:58 AM To: Yingzhen Qu <yingzhen.qu@futurewei.com<mailto:yingzhen.qu@futurewei.com>>, Alexander L Clemm <ludwig@clemm.org<mailto:ludwig@clemm.org>>, "yang-doctors@ietf.org<mailto:yang-doctors@ietf.org>" <yang-doctors@ietf.org<mailto:yang-doctors@ietf.org>> Cc: "last-call@ietf.org<mailto:last-call@ietf.org>" <last-call@ietf.org<mailto:last-call@ietf.org>>, "netmod@ietf.org<mailto:netmod@ietf.org>" <netmod@ietf.org<mailto:netmod@ietf.org>>, "draft-ietf-netmod-nmda-diff.all@ietf.org<mailto:draft-ietf-netmod-nmda-diff.all@ietf.org>" <draft-ietf-netmod-nmda-diff.all@ietf.org<mailto:draft-ietf-netmod-nmda-diff.all@ietf.org>> Subject: Re: [yang-doctors] [netmod] Yangdoctors last call review of draft-ietf-netmod-nmda-diff-04 Hi Yingzhen, Yes I believe this part is broken, since you have multiple edit-id elements for 1 edit element, below is the YANG snippet from RFC8072. list edit { key edit-id; ordered-by user; <snip> leaf edit-id { type string; description "Arbitrary string index for the edit. Error messages returned by the server that pertain to a specific edit will be identified by this value."; } If you take a look at A.1.1 of RFC8072, there is an example with multiple edit elements. Regards, Reshad. From: Yingzhen Qu <yingzhen.qu@futurewei.com<mailto:yingzhen.qu@futurewei.com>> Date: Friday, September 25, 2020 at 1:07 AM To: "Reshad Rahman (rrahman)" <rrahman@cisco.com<mailto:rrahman@cisco.com>>, Alexander L Clemm <ludwig@clemm.org<mailto:ludwig@clemm.org>>, "yang-doctors@ietf.org<mailto:yang-doctors@ietf.org>" <yang-doctors@ietf.org<mailto:yang-doctors@ietf.org>> Cc: "last-call@ietf.org<mailto:last-call@ietf.org>" <last-call@ietf.org<mailto:last-call@ietf.org>>, "netmod@ietf.org<mailto:netmod@ietf.org>" <netmod@ietf.org<mailto:netmod@ietf.org>>, "draft-ietf-netmod-nmda-diff.all@ietf.org<mailto:draft-ietf-netmod-nmda-diff.all@ietf.org>" <draft-ietf-netmod-nmda-diff.all@ietf.org<mailto:draft-ietf-netmod-nmda-diff.all@ietf.org>> Subject: Re: [yang-doctors] [netmod] Yangdoctors last call review of draft-ietf-netmod-nmda-diff-04 Hi Reshad, Thank you for your review. About the example, in RFC 8072, in the list “edit”, each edit is identified by “edit-id”. So the example looks like: <edit> <edit-id>1</edit-id> ….. <edit-id>2</edit-id> …. </edit> Do you mean this part is broken? Thanks, Yingzhen From: "Reshad Rahman (rrahman)" <rrahman@cisco.com<mailto:rrahman@cisco.com>> Date: Tuesday, September 22, 2020 at 6:07 AM To: Alexander L Clemm <ludwig@clemm.org<mailto:ludwig@clemm.org>>, "yang-doctors@ietf.org<mailto:yang-doctors@ietf.org>" <yang-doctors@ietf.org<mailto:yang-doctors@ietf.org>> Cc: "last-call@ietf.org<mailto:last-call@ietf.org>" <last-call@ietf.org<mailto:last-call@ietf.org>>, "netmod@ietf.org<mailto:netmod@ietf.org>" <netmod@ietf.org<mailto:netmod@ietf.org>>, "draft-ietf-netmod-nmda-diff.all@ietf.org<mailto:draft-ietf-netmod-nmda-diff.all@ietf.org>" <draft-ietf-netmod-nmda-diff.all@ietf.org<mailto:draft-ietf-netmod-nmda-diff.all@ietf.org>> Subject: Re: [yang-doctors] [netmod] Yangdoctors last call review of draft-ietf-netmod-nmda-diff-04 Resent-From: <alias-bounces@ietf.org<mailto:alias-bounces@ietf.org>> Resent-To: <ludwig@clemm.org<mailto:ludwig@clemm.org>>, <yqu@futurewei.com<mailto:yqu@futurewei.com>>, <jefftant.ietf@gmail.com<mailto:jefftant.ietf@gmail.com>>, <andy@yumaworks.com<mailto:andy@yumaworks.com>>, <lberger@labn.net<mailto:lberger@labn.net>>, <kent+ietf@watsen.net<mailto:kent+ietf@watsen.net>>, <joelja@bogus.com<mailto:joelja@bogus.com>>, <warren@kumari.net<mailto:warren@kumari.net>>, <rwilton@cisco.com<mailto:rwilton@cisco.com>>, Joel Jaeggli <joelja@gmail.com<mailto:joelja@gmail.com>>, <joelja@gmail.com<mailto:joelja@gmail.com>> Resent-Date: Tuesday, September 22, 2020 at 6:07 AM Hi Alex, Thank you for addressing my comments. I checked rev-06, and I believe the XML and JSON output in the example is broken: there is a single “edit” element with multiple “edit-id” elements. I believe there should be multiple “edit” elements. The only “nit” is that leaf-xpath-filter references 6021 instead of 6991 (as you correctly pointed out in your response). leaf xpath-filter { if-feature nc:xpath; type yang:xpath1.0; description "This parameter contains an XPath expression identifying the portions of the target datastore to retrieve."; reference "RFC 6021: Common YANG Data Types"; } > Issues > 1. YANG model P8, for “leaf xpath-filter”, add reference to RFC6021. There should also be a normative reference to RFC6021 (as per RFC8407) <ALEX> Thanks. Adding reference to 6991 (as 6021 is obsoleted). </ALEX> Regards, Reshad. From: Alexander L Clemm <ludwig@clemm.org<mailto:ludwig@clemm.org>> Date: Friday, September 18, 2020 at 3:48 PM To: "Reshad Rahman (rrahman)" <rrahman@cisco.com<mailto:rrahman@cisco.com>>, "yang-doctors@ietf.org<mailto:yang-doctors@ietf.org>" <yang-doctors@ietf.org<mailto:yang-doctors@ietf.org>> Cc: "last-call@ietf.org<mailto:last-call@ietf.org>" <last-call@ietf.org<mailto:last-call@ietf.org>>, "netmod@ietf.org<mailto:netmod@ietf.org>" <netmod@ietf.org<mailto:netmod@ietf.org>>, "draft-ietf-netmod-nmda-diff.all@ietf.org<mailto:draft-ietf-netmod-nmda-diff.all@ietf.org>" <draft-ietf-netmod-nmda-diff.all@ietf.org<mailto:draft-ietf-netmod-nmda-diff.all@ietf.org>> Subject: Re: [yang-doctors] [netmod] Yangdoctors last call review of draft-ietf-netmod-nmda-diff-04 Thank you! I just uploaded rev -06. --- Alex On 9/18/2020 12:47 PM, Reshad Rahman (rrahman) wrote: Hi Alex, This addresses my comment/concern. Regards, Reshad. From: Alexander L Clemm <ludwig@clemm.org><mailto:ludwig@clemm.org> Date: Friday, September 18, 2020 at 3:43 PM To: "Reshad Rahman (rrahman)" <rrahman@cisco.com><mailto:rrahman@cisco.com>, "yang-doctors@ietf.org"<mailto:yang-doctors@ietf.org> <yang-doctors@ietf.org><mailto:yang-doctors@ietf.org> Cc: "last-call@ietf.org"<mailto:last-call@ietf.org> <last-call@ietf.org><mailto:last-call@ietf.org>, "netmod@ietf.org"<mailto:netmod@ietf.org> <netmod@ietf.org><mailto:netmod@ietf.org>, "draft-ietf-netmod-nmda-diff.all@ietf.org"<mailto:draft-ietf-netmod-nmda-diff.all@ietf.org> <draft-ietf-netmod-nmda-diff.all@ietf.org><mailto:draft-ietf-netmod-nmda-diff.all@ietf.org> Subject: Re: [yang-doctors] [netmod] Yangdoctors last call review of draft-ietf-netmod-nmda-diff-04 Hi Reshad, okay, so let's add the following then to section 4, in the explanation of the "differences" output parameter: "When a datastore node in the source of the comparison is not present in the target of the comparison, this can be indicated either as a "delete" or as a "remove" in the patch as there is no differentiation between those operations for the purposes of the comparison. " And update the description as follows: container differences { description "The list of differences, encoded per RFC8072 with an augmentation to include source values where applicable. When a datastore node in the source is not present in the target, this can be indicated either as a 'delete' or as a 'remove' as there is no difference between them for the purposes of the comparison."; ... I will post this in a -06 shortly. Please let us know if this addresses your concerns or if there is anything else. Thanks! --- Alex On 9/18/2020 5:57 AM, Reshad Rahman (rrahman) wrote: Hi Alex, I think the only “problem” with using both “remove” and “delete” is that it could be confusing (when should one be used and not the other). Adding some text to say they’re the same for the diff operation is good enough for me. Regards, Reshad. From: Alexander L Clemm <ludwig@clemm.org><mailto:ludwig@clemm.org> Date: Tuesday, September 15, 2020 at 7:31 PM To: "Reshad Rahman (rrahman)" <rrahman@cisco.com><mailto:rrahman@cisco.com>, "yang-doctors@ietf.org"<mailto:yang-doctors@ietf.org> <yang-doctors@ietf.org><mailto:yang-doctors@ietf.org> Cc: "last-call@ietf.org"<mailto:last-call@ietf.org> <last-call@ietf.org><mailto:last-call@ietf.org>, "netmod@ietf.org"<mailto:netmod@ietf.org> <netmod@ietf.org><mailto:netmod@ietf.org>, "draft-ietf-netmod-nmda-diff.all@ietf.org"<mailto:draft-ietf-netmod-nmda-diff.all@ietf.org> <draft-ietf-netmod-nmda-diff.all@ietf.org><mailto:draft-ietf-netmod-nmda-diff.all@ietf.org> Subject: Re: [yang-doctors] [netmod] Yangdoctors last call review of draft-ietf-netmod-nmda-diff-04 Hi Reshad, re: question 1: As you indicate, there may be no distinction between indicating a "remove" or a "delete" in the patch. Right now it would be acceptable to return either. If we want to eliminate this freedom, which one would you prefer be used? Shall we remove the possibility for "delete" and just cover it using "remove"? Note that the place where this is specified in the model is as part of a condition that specifies when the source value should be included. If we want to rule out that diff can return either "remove" or "delete" (indeed they are synonymous), we would need to add text to the container description that when a data object is present in the target of the comparison but not the source, that "remove" should be used to indicate that. The model would be changed follows. Please confirm if this looks good to you & we'll incorporate it. OLD container differences { description "The list of differences, encoded per RFC8072<https://nam11.safelinks.protection.outlook.com/?url=https%3A%2F%2Ftools.ietf.org%2Fhtml%2Frfc8072&data=02%7C01%7Calex%40futurewei.com%7C0f32962064e242119f1108d86172362c%7C0fee8ff2a3b240189c753a1d5591fedc%7C1%7C1%7C637366490474870208&sdata=ZhyS14WI5SBCfZBXlkgxxx8QEjGpjkIQMYQ4UbRbQhk%3D&reserved=0> with an augmentation to include source values where applicable."; uses ypatch:yang-patch { augment "yang-patch/edit" { description "Provide the value of the source of the patch, respectively of the comparison, in addition to the target value, where applicable."; anydata source-value { when "../operation = 'delete'" + "or ../operation = 'merge'" + "or ../operation = 'move'" + "or ../operation = 'replace'" + "or ../operation = 'remove'"; description "The anydata 'value' is only used for 'delete', 'move', 'merge', 'replace', and 'remove' operations."; } reference "RFC 8072<https://nam11.safelinks.protection.outlook.com/?url=https%3A%2F%2Ftools.ietf.org%2Fhtml%2Frfc8072&data=02%7C01%7Calex%40futurewei.com%7C0f32962064e242119f1108d86172362c%7C0fee8ff2a3b240189c753a1d5591fedc%7C1%7C1%7C637366490474880202&sdata=KsgJFMriEx2pi0LWkXWfy6CyeIPfd03byz2ZucMPoRU%3D&reserved=0>: YANG Patch Media Type"; } } } NEW: container differences { description "The list of differences, encoded per RFC8072<https://nam11.safelinks.protection.outlook.com/?url=https%3A%2F%2Ftools.ietf.org%2Fhtml%2Frfc8072&data=02%7C01%7Calex%40futurewei.com%7C0f32962064e242119f1108d86172362c%7C0fee8ff2a3b240189c753a1d5591fedc%7C1%7C1%7C637366490474880202&sdata=KsgJFMriEx2pi0LWkXWfy6CyeIPfd03byz2ZucMPoRU%3D&reserved=0> with an augmentation to include source values where applicable. Where a difference include a data object in the target that is not present in the source, this shall be indicated as a 'remove' operation in the patch, not as a 'delete' operation."; uses ypatch:yang-patch { augment "yang-patch/edit" { description "Provide the value of the source of the patch, respectively of the comparison, in addition to the target value, where applicable."; anydata source-value { when "../operation = 'merge'" + "or ../operation = 'move'" + "or ../operation = 'replace'" + "or ../operation = 'remove'"; description "The anydata 'value' is only used for 'merge', 'move','replace', and 'remove' operations."; } reference "RFC 8072<https://nam11.safelinks.protection.outlook.com/?url=https%3A%2F%2Ftools.ietf.org%2Fhtml%2Frfc8072&data=02%7C01%7Calex%40futurewei.com%7C0f32962064e242119f1108d86172362c%7C0fee8ff2a3b240189c753a1d5591fedc%7C1%7C1%7C637366490474890186&sdata=HI7FszS1y32mk12k0%2BVHYQJt24JaEzEsoss1uFADdpc%3D&reserved=0>: YANG Patch Media Type"; } } } Thanks --- Alex On 9/15/2020 4:04 PM, Reshad Rahman (rrahman) wrote: Hi Alex, I will review the latest version. See below for questions/responses. On 2020-09-15, 5:19 PM, "yang-doctors on behalf of Alexander L Clemm" <yang-doctors-bounces@ietf.org on behalf of ludwig@clemm.org><mailto:yang-doctors-bounces@ietf.orgonbehalfofludwig@clemm.org> wrote: Hello Reshad, hello YANG Doctors, thank you for your review! Please find my replies inline, <ALEX>. We have also just posted -05 (thanks, Yingzhen, for doublechecking my updates). --- Alex on behalf of coauthors On 9/7/2020 7:06 AM, Reshad Rahman (rrahman) wrote: > <Here's the same message with hopefully more readable formatting> > > Review of rev -04 by Reshad Rahman > > The document is clear and well-written. While some issues have been identified, they can be resolved quickly. > <snip> > Questions > 1. YANG model: does the operation “delete” make sense for a diff operation? If it is kept, it’d be good to have some text explaining that for a diff operation, “delete” and “replace” are the same? If they’re not the same, please also add some text…. <RR> I actually meant "delete" and "remove". <ALEX> Here we are simply referring to the basic YANG-patch edit operations per https://tools.ietf.org/html/rfc8072#page-11<https://nam11.safelinks.protection.outlook.com/?url=https%3A%2F%2Ftools.ietf.org%2Fhtml%2Frfc8072%23page-11&data=02%7C01%7Calex%40futurewei.com%7C0f32962064e242119f1108d86172362c%7C0fee8ff2a3b240189c753a1d5591fedc%7C1%7C1%7C637366490474890186&sdata=LADW9OYrjZOJ0Nv5clbHcSf41eoS1NXpNejWb8A8zeQ%3D&reserved=0>. Those are in turn derived from <edit-config> operations per https://tools.ietf.org/html/rfc6241#page-37<https://nam11.safelinks.protection.outlook.com/?url=https%3A%2F%2Ftools.ietf.org%2Fhtml%2Frfc6241%23page-37&data=02%7C01%7Calex%40futurewei.com%7C0f32962064e242119f1108d86172362c%7C0fee8ff2a3b240189c753a1d5591fedc%7C1%7C1%7C637366490474900180&sdata=870DbV9BaYJ%2FfdIS3D0ECD4EdfseNsH7Kah3KsqsbrE%3D&reserved=0>. I am not sure we need add to explain those, as we are directly referring to YANG-patch. </ALEX> <RR> The operations are indeed well defined in RFC8072 (copied below), but they are defined from the perspective of YANG-Patch. So for YANG-Patch "delete" and "remove" are different operations, but from a diff comparison I believe they are the same (the resource must exist since it's being returned in a diff) +-----------+-----------------------------------------------------------------+ | delete | delete a data resource if it already exists; if it | | | does not exist, return an error | | | | | remove | remove a data resource if it already exists | +-----------+-----------------------------------------------------------------+ > 3. YANG model P9, for the “uses path:yang-patch”, why not have a reference to RFC8072 (is it because the description above mentions RFC8072)? <ALEX> We are clearly referencing RFC 8072; are you suggesting to put a reference substatement below the uses statement? It looks a little strange to me but sure, we will add it. <RR> Not needed. > 4. Section 7 mentions rate limiting requests per client. Should there be a “global” rate-limiting too, i.e not client-specific? <ALEX> I am not sure this is really needed as I think the number of management clients will in general be fairly limited to begin with, but we can certainly add it. How about the following text: OLD: One possibility for an implementation to mitigate against such a possibility is to limit the number of requests that is served to a client in any one time interval, rejecting requests made at a higher frequency than the implementation can reasonably sustain. NEW: One possibility for an implementation to mitigate against such a possibility is to limit the number of requests that is served to a client, or to any number of clients, in any one time interval, rejecting requests made at a higher frequency than the implementation can reasonably sustain. <RR> Good with me. </ALEX> > 5. Wondering if section 8 should be in an Appendix (or even removed)? Also, the method suggested doesn’t seem to guarantee that the difference persisted for the “dampening” time. <ALEX> Personally, I do think it makes sense to include a brief discussion of possible further extensions. I suggest to keep the section if it's okay with you, or perhaps leave it to the chair whether they have a preference to remove it. </ALEX> <RR>Whatever the WG/chairs decide is fine with me. Regards, Reshad.
- [netmod] Yangdoctors last call review of draft-ie… Reshad Rahman via Datatracker
- Re: [netmod] [yang-doctors] Yangdoctors last call… Reshad Rahman (rrahman)
- Re: [netmod] [yang-doctors] Yangdoctors last call… Alexander L Clemm
- Re: [netmod] [yang-doctors] Yangdoctors last call… Reshad Rahman (rrahman)
- Re: [netmod] [yang-doctors] Yangdoctors last call… Alexander L Clemm
- Re: [netmod] [yang-doctors] Yangdoctors last call… Reshad Rahman (rrahman)
- Re: [netmod] [yang-doctors] Yangdoctors last call… Alexander L Clemm
- Re: [netmod] [yang-doctors] Yangdoctors last call… Reshad Rahman (rrahman)
- Re: [netmod] [yang-doctors] Yangdoctors last call… Alexander L Clemm
- Re: [netmod] [yang-doctors] Yangdoctors last call… Reshad Rahman (rrahman)
- Re: [netmod] [yang-doctors] Yangdoctors last call… Yingzhen Qu
- Re: [netmod] [yang-doctors] Yangdoctors last call… Reshad Rahman (rrahman)
- Re: [netmod] [yang-doctors] Yangdoctors last call… Yingzhen Qu
- Re: [netmod] [yang-doctors] Yangdoctors last call… Reshad Rahman (rrahman)
- Re: [netmod] [yang-doctors] Yangdoctors last call… Yingzhen Qu
- Re: [netmod] [yang-doctors] Yangdoctors last call… Reshad Rahman (rrahman)
- Re: [netmod] [yang-doctors] Yangdoctors last call… Alexander Clemm