Re: [netmod] WG Last Call: draft-ietf-netmod-yang-instance-file-format-06 to -07

Balázs Lengyel <balazs.lengyel@ericsson.com> Thu, 19 March 2020 12:08 UTC

Return-Path: <balazs.lengyel@ericsson.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 7D6703A283C for <netmod@ietfa.amsl.com>; Thu, 19 Mar 2020 05:08:54 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -3.564
X-Spam-Level:
X-Spam-Status: No, score=-3.564 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_MSPIKE_H2=-1.463, 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=ericsson.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 JWEtk8--jJw8 for <netmod@ietfa.amsl.com>; Thu, 19 Mar 2020 05:08:53 -0700 (PDT)
Received: from EUR05-VI1-obe.outbound.protection.outlook.com (mail-vi1eur05on2086.outbound.protection.outlook.com [40.107.21.86]) (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 A2CDE3A2838 for <netmod@ietf.org>; Thu, 19 Mar 2020 05:08:52 -0700 (PDT)
ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; =?utf-8?q?b=3DUhrAVrAgh6RkspbMCpbZW9Yd/kyShTxBydym6AsP8Mz0hyFzqp9tKrcnoX6MT?= =?utf-8?q?gcRTtkxTBQiBI0X2VhXQWkc31RGDjKgddzLQkY2st38HwHwzsnD+79IAcPEnWtYmg?= =?utf-8?q?neEUqmjtIuuL+Fjo02WD28JIpzNGKWs2wsHyiNaXvu0w7zWWVYQGbHIfpkMnEhbk3?= =?utf-8?q?QUSXz39hEzhr9uB92TXgjHAKysSCDri/udBP46FxIvkcziWAWPPDJGskaD11tzW87?= =?utf-8?q?4sA+6iBRiBktR81DFoq6SXzo4UgacjbOEXOuZvMHDN7uy2FeSNzxEB9TobB9duVfN?= =?utf-8?q?jLgD/8pM7peILab47e0eA=3D=3D?=
ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; =?utf-8?q?h=3DFrom=3ADate=3ASubject=3AMessage-ID=3ACont?= =?utf-8?q?ent-Type=3AMIME-Version=3AX-MS-Exchange-SenderADCheck=3B?= =?utf-8?q?bh=3DNBIBqXLag9yNJdC8fB9K/PrZcRChDUCPiH9teom7ppg=3D=3B_b=3DKSsHO2?= =?utf-8?q?boBeCCDOdLTl1OPJUzHAHiEugPJzMAIZs+hl1CLdf+aNZLBWLNNOfuejXd03ON+lE?= =?utf-8?q?Jf1kJ49SxiiQcbiuzGhcxIPpbvAJDvr5mmz3QT+PHGE3tC5mo9wTbaSI8I3Eey/KX?= =?utf-8?q?Pb/pBli4JRy/6BTGHebpyJgjA2bz7ic4FlvGngkeFrSjuS0bhjS8g1hS56ZREH70D?= =?utf-8?q?0dXorLWXGyCiT8mDzuCBE9YZRTaJnoXgzPcpC8uKY77E4nOdhlwman0UumUKWTsIl?= =?utf-8?q?NUm01DqtAnOJCfJtbr+auj7PAe3rJP1EYgpTSb76sR0owGHlInWOo+/icOVdykwMP?= =?utf-8?q?Dd25KJBEhQg=3D=3D?=
ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=ericsson.com; dmarc=pass action=none header.from=ericsson.com; dkim=pass header.d=ericsson.com; arc=none
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ericsson.com; s=selector1; =?utf-8?q?h=3DFrom=3ADate=3ASubject=3AMessage-ID=3AContent-Typ?= =?utf-8?q?e=3AMIME-Version=3AX-MS-Exchange-SenderADCheck=3B?= =?utf-8?q?bh=3DNBIBqXLag9yNJdC8fB9K/PrZcRChDUCPiH9teom7ppg=3D=3B_b=3DP92tUm?= =?utf-8?q?/etZNhS0pAgHkmUj8Ms9T1aeS4KaUhhq1x6C+BuZEDY0NgcbkjjsFbVV+qEkMRCyl?= =?utf-8?q?BoVdUvT5k2a25lEdr1bj8QYXuNSwTi9e/geB/a2Klh1kairM6y3IB6beqITobzfwd?= =?utf-8?q?jY0aqRckzcwqYYPKQaq/6dj1X7mlJFUte5I=3D?=
Received: from DB7PR07MB4011.eurprd07.prod.outlook.com (52.134.97.155) by DB7PR07MB5047.eurprd07.prod.outlook.com (20.177.194.28) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.2835.6; Thu, 19 Mar 2020 12:08:48 +0000
Received: from DB7PR07MB4011.eurprd07.prod.outlook.com ([fe80::15cf:dc81:c6f4:aa0c]) by DB7PR07MB4011.eurprd07.prod.outlook.com ([fe80::15cf:dc81:c6f4:aa0c%7]) with mapi id 15.20.2835.013; Thu, 19 Mar 2020 12:08:48 +0000
From: =?utf-8?B?QmFsw6F6cyBMZW5neWVs?= <balazs.lengyel@ericsson.com>
To: Kent Watsen <kent+ietf@watsen.net>
CC: "netmod@ietf.org" <netmod@ietf.org>
Thread-Topic: [netmod] WG Last Call: draft-ietf-netmod-yang-instance-file-format-06 to -07
Thread-Index: AdXjRaul/baoBR3OSym1n0wm+wChUgAJWeEAA+aGbsACcvWXgAAj8s4AACFBcwA=
Date: Thu, 19 Mar 2020 12:08:48 +0000
Message-ID: =?utf-8?q?=3CDB7PR07MB4011E19D9E3E16E96036F325F0F40=40DB7PR07MB4?= =?utf-8?q?011=2Eeurprd07=2Eprod=2Eoutlook=2Ecom=3E?=
References: =?utf-8?q?=3CDB7PR07MB4011402E836C2FABCB3E7F42F0150=40DB7PR07MB4?= =?utf-8?q?011=2Eeurprd07=2Eprod=2Eoutlook=2Ecom=3E_=3C0100017045205157-ba7a?= =?utf-8?q?6e8f-0d4d-4540-b6ca-94d4d81dbe02-000000=40email=2Eamazonses=2Ecom?= =?utf-8?q?=3E_=3CDB7PR07MB40119ED41717889CFACC08F4F0E30=40DB7PR07MB4011=2Ee?= =?utf-8?q?urprd07=2Eprod=2Eoutlook=2Ecom=3E_=3C01000170eb9368e1-3f3186d5-97?= =?utf-8?q?92-492a-8a33-4bb589552b6d-000000=40email=2Eamazonses=2Ecom=3E_=3C?= =?utf-8?q?01000170ef41c649-255d0811-a030-4b60-9d1f-a06d39f4ebf8-000000=40em?= =?utf-8?q?ail=2Eamazonses=2Ecom=3E?=
In-Reply-To: =?utf-8?q?=3C01000170ef41c649-255d0811-a030-4b60-9d1f-a06d39f4e?= =?utf-8?q?bf8-000000=40email=2Eamazonses=2Ecom=3E?=
Accept-Language: en-US
Content-Language: en-US
X-MS-Has-Attach: yes
X-MS-TNEF-Correlator:
authentication-results: spf=none (sender IP is ) smtp.mailfrom=balazs.lengyel@ericsson.com;
x-originating-ip: [80.98.254.17]
x-ms-publictraffictype: Email
x-ms-office365-filtering-correlation-id: 1c5b8f3c-c0ce-41f1-dffa-08d7cbfe4813
x-ms-traffictypediagnostic: DB7PR07MB5047:
x-microsoft-antispam-prvs: =?utf-8?q?=3CDB7PR07MB5047A6A859C2347C6B55BE4FF0F?= =?utf-8?q?40=40DB7PR07MB5047=2Eeurprd07=2Eprod=2Eoutlook=2Ecom=3E?=
x-ms-oob-tlc-oobclassifiers: OLM:8882;
x-forefront-prvs: 0347410860
x-forefront-antispam-report: SFV:NSPM; =?utf-8?q?SFS=3A=2810009020=29=284636?= =?utf-8?b?MDA5KSgzNjYwMDQpKDEzNjAwMykoMzc2MDAyKSgzOTYwMDMpKDM5ODYwNDAw?= =?utf-8?b?MDAyKSgzNDYwMDIpKDE5OTAwNCkoODUyMDIwMDMpKDY2NjE2MDA5KSg1NTAx?= =?utf-8?q?6002=29=2852536014=29=285660300002=29=28186003=29=2886362001=29?= =?utf-8?q?=28316002=29=2876116006=29=2866946007=29=2866446008=29=2871200400?= =?utf-8?b?MDAxKSgzMzY1NjAwMikoNDc4NjAwMDAxKSg2NjQ3NjAwNykoNDMyNjAwOCko?= =?utf-8?q?66556008=29=2864756008=29=2881156014=29=2881166006=29=287696005?= =?utf-8?b?KSg4Njc2MDAyKSg5Njg2MDAzKSg4OTM2MDAyKSg4NTE4MjAwMSkoNTM1NDYwMTEp?= =?utf-8?q?=2826005=29=282906002=29=286506007=29=3B?= DIR:OUT; SFP:1101; SCL:1; SRVR:DB7PR07MB5047; H:DB7PR07MB4011.eurprd07.prod.outlook.com; FPR:; SPF:None; LANG:en; PTR:InfoNoRecords; A:1;
received-spf: None (protection.outlook.com: ericsson.com does not designate permitted sender hosts)
x-ms-exchange-senderadcheck: 1
x-microsoft-antispam: BCL:0;
x-microsoft-antispam-message-info: =?utf-8?q?3x3pJHpyRKkYKn3vDVwJHeRzplmu+ms?= =?utf-8?q?LmWNet+itPTmbWqdVJI2glT16/8vKDvbRBLcAISZAsNoN0T7i0tQYwWVyv3MTSHdy?= =?utf-8?q?T2guxg3sIeEV+Zavx4QgTGbtFRfEQDwLgkRVWFQ/x162fYPpLvBaJWchU0VsCawOs?= =?utf-8?q?KCsmLSmLLLJqG56LF8dsgWT5KJhinXFn8jhS7gcCWqJPPiqPp8/NuWwWLR9hgY9wT?= =?utf-8?q?+Yit8QSalDIAnvbfQOxVoUAjQ4a15Gj7Ss+C6iMtJj90XaU1IXhrDHaLDrCM2akTl?= =?utf-8?q?dc2v5VLmzm7cw0C8JVHfNLjLPIw99Ap4hP5ZEMa3C3jKS+slXluW2L/ppuFSOb50F?= =?utf-8?q?aCIBCExIhubKUAEmeNYu2tCGN1RKM5noR747GdVUW9BnF0hRGdlRR4HmSTIbN9Nhy?= =?utf-8?q?/c22b5+F1REmU3zeuaf/0meInVh?=
x-ms-exchange-antispam-messagedata: =?utf-8?q?N0fZrZnirpj0thbkyjU+qu53KGszpE?= =?utf-8?q?34euw+S/HHYrusx8edhMZaTQr1h4MOqcOyaBwMCWxLfVXAil5WBOT4ukqkQjofxxe?= =?utf-8?q?OWSXW7qO4gOf2U1rZZHOTps4brnDHDq3irhXeMQiB+r4ok/s2l3sDUw=3D=3D?=
x-ms-exchange-transport-forked: True
Content-Type: multipart/signed; protocol="application/x-pkcs7-signature"; micalg=SHA1; boundary="----=_NextPart_000_004D_01D5FDEF.86656260"
MIME-Version: 1.0
X-OriginatorOrg: ericsson.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 1c5b8f3c-c0ce-41f1-dffa-08d7cbfe4813
X-MS-Exchange-CrossTenant-originalarrivaltime: 19 Mar 2020 12:08:48.6558 (UTC)
X-MS-Exchange-CrossTenant-fromentityheader: Hosted
X-MS-Exchange-CrossTenant-id: 92e84ceb-fbfd-47ab-be52-080c6b87953f
X-MS-Exchange-CrossTenant-mailboxtype: HOSTED
X-MS-Exchange-CrossTenant-userprincipalname: =?utf-8?q?LXY0H5SmkKHuxfZ01YpBk?= =?utf-8?q?10Kuy2z7tYxfCW9WaVSvtK7Snf3L0cxz/cXTkX2flftZ8+325hpuxCfkO0uELcAzz?= =?utf-8?q?jGezgZI0/NYtV+RbMZVBs=3D?=
X-MS-Exchange-Transport-CrossTenantHeadersStamped: DB7PR07MB5047
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/PDFYL8Q2NFDwx56eFgPctYRqG6E>
Subject: Re: [netmod] WG Last Call: draft-ietf-netmod-yang-instance-file-format-06 to -07
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, 19 Mar 2020 12:08:55 -0000


-----Original Message-----
From: Kent Watsen <kent+ietf@watsen.net> 
Sent: 2020. március 18., szerda 21:07
To: Balázs Lengyel <balazs.lengyel@ericsson.com>
Cc: netmod@ietf.org
Subject: Re: [netmod] WG Last Call: draft-ietf-netmod-yang-instance-file-format-06 to -07

One more thing, for non-mandatory nodes that don’t have a default value specified, please ensure the “description” statement states what it means for the node to be set or not set (whichever is easier)?   For instance:

OLD:

       leaf name {
         type string;
         description
           "Name of the YANG instance data set.";
       }

NEW (assuming this makes sense):

       leaf name {
         type string;
         description
           “An arbitrary name for the YANG instance data set.  This
            value is primarily used for descriptive purposes.  However,
            when the instance data set is saved to a file, then the
            filename MUST encode the name’s value, per Section 3 
            of RFC XXXX.";
       }
BALAZS: OK
BTW, should the requirement of it needing to be encoded into the filename place constraints on the “string” type?  Should a “pattern”
statement be added?
BALAZS: IMHO defining a pattern for a filename string (that may be dependent on the used filesystem) is out of scope for this draft.

Extended description of content-schema.
IMHO contact, description, revision, timestamp does not need to explain what does it mean if they are not present. It only means: no information available.
Kent