Re: [alto] Last Call: <draft-ietf-alto-oam-yang-12.txt> (YANG Data Models for the Application-Layer Traffic Optimization (ALTO) Protocol) to Proposed Standard

tom petch <daedulus@btconnect.com> Mon, 25 September 2023 15:36 UTC

Return-Path: <daedulus@btconnect.com>
X-Original-To: alto@ietfa.amsl.com
Delivered-To: alto@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id EBA9EC153CBB; Mon, 25 Sep 2023 08:36:17 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -6.911
X-Spam-Level:
X-Spam-Status: No, score=-6.911 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, RCVD_IN_DNSWL_HI=-5, RCVD_IN_MSPIKE_H2=-0.001, RCVD_IN_ZEN_BLOCKED_OPENDNS=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=btconnect.onmicrosoft.com
Received: from mail.ietf.org ([50.223.129.194]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 0BLlKQEK-m90; Mon, 25 Sep 2023 08:36:16 -0700 (PDT)
Received: from EUR05-AM6-obe.outbound.protection.outlook.com (mail-am6eur05on2126.outbound.protection.outlook.com [40.107.22.126]) (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 13614C153CA1; Mon, 25 Sep 2023 08:36:09 -0700 (PDT)
ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=F3GgwSlLzL6hZBONHMGSVVBLozgCkr8Q6oGxlV+GsfkruZpAw/KKsxQzTbMFQuTrrg/XPcJdFuTXbGn4KZcH+FV8Ld+rtJzW8H1c9Jm+CP5RDGSesC5IwR0nxzo5NFqHpG02EkG2Y+cICkgv31SQC1I2yRtYfZfEN6Ey278MZcy/+DbmbHxBiaTXeLl5ok9yf/gndUAHAPQCFroXIwW140EZ8+4ewZgdsoxLWEQBFXIqMj/BePEaMZLTXJrY6BRU5qnyJKSvT6L2pUAka1QO8NgbeeeZyn2KTb31bx5OWD11pvuSe0cQzwSZcsrxSk6gyM6qYQ1Fy8NNu4MWm65ojA==
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-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=G/jcWeAYlR339flNHdCQs177y5t4/+QvZvkhiYruuzg=; b=AgrM8yD6pBL6ufkRf0qq6/lkHkiLhAPJUw9nhFUbsg8gr9buKoymRND41oZlxVaJ+W+rSXhXrwTn0Mtc/+UetWZIq7evZnNdRishJCHXLvzmkN0Mmo6hlLk6CmmegYT/AlEbK6gyS41Jag1k2lut5RMgJGohPS62VFQ7oBFjAzeIPI5yfym3kKgDb8xHYkUN+kDL2FbxZ9hm3877bFnSOOn/CoZHSUk3Z6jU/ngzBLOLyvuaXDbkkFGO7mH6XkwBgGf1wbmK/ooM0fts6WTVD71lekEHGouppf/1ugviBlzZigAs+l/iZKIOEyuPH8RpFlBHm+/XfcdN6bhpnp4wwA==
ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=btconnect.com; dmarc=pass action=none header.from=btconnect.com; dkim=pass header.d=btconnect.com; arc=none
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=btconnect.onmicrosoft.com; s=selector2-btconnect-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=G/jcWeAYlR339flNHdCQs177y5t4/+QvZvkhiYruuzg=; b=UTp7KJUUJdxAJDYZNwhewjNybGleWwnoQ8AuhQrMoroXAJYr37CzA4N2BuEbxFy5xAdwD334lpXvCGjAoQ1XYToogpH6YjAevzRPZMtIXdDxhW4TZbHXJU361fC7vd6v/fPBWVYYRRM3QotVb9SCVBn6tK+p14Ond4WlS+ZGgW0=
Received: from VI1PR07MB6704.eurprd07.prod.outlook.com (2603:10a6:800:18b::8) by PR3PR07MB6539.eurprd07.prod.outlook.com (2603:10a6:102:60::19) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6813.28; Mon, 25 Sep 2023 15:36:07 +0000
Received: from VI1PR07MB6704.eurprd07.prod.outlook.com ([fe80::981:77a3:1d89:dbae]) by VI1PR07MB6704.eurprd07.prod.outlook.com ([fe80::981:77a3:1d89:dbae%6]) with mapi id 15.20.6813.027; Mon, 25 Sep 2023 15:36:07 +0000
From: tom petch <daedulus@btconnect.com>
To: "mohamed.boucadair@orange.com" <mohamed.boucadair@orange.com>, "last-call@ietf.org" <last-call@ietf.org>
CC: "alto-chairs@ietf.org" <alto-chairs@ietf.org>, "alto@ietf.org" <alto@ietf.org>, "draft-ietf-alto-oam-yang@ietf.org" <draft-ietf-alto-oam-yang@ietf.org>
Thread-Topic: Last Call: <draft-ietf-alto-oam-yang-12.txt> (YANG Data Models for the Application-Layer Traffic Optimization (ALTO) Protocol) to Proposed Standard
Thread-Index: AQHZ7W76ecu0vef2mEKRLKcn8PJZB7Arc00LgAARRhCAACn8QQ==
Date: Mon, 25 Sep 2023 15:36:06 +0000
Message-ID: <VI1PR07MB6704F49148DE42F12FC2553DC6FCA@VI1PR07MB6704.eurprd07.prod.outlook.com>
References: <169539880679.14638.14603557957902222631@ietfa.amsl.com> <VI1PR07MB6704AAED540AA4A2431498A2C6FCA@VI1PR07MB6704.eurprd07.prod.outlook.com> <DU2PR02MB101608E1BC65CE9CA8FBE5CDF88FCA@DU2PR02MB10160.eurprd02.prod.outlook.com>
In-Reply-To: <DU2PR02MB101608E1BC65CE9CA8FBE5CDF88FCA@DU2PR02MB10160.eurprd02.prod.outlook.com>
Accept-Language: en-GB, en-US
Content-Language: en-GB
X-MS-Has-Attach:
X-MS-TNEF-Correlator:
msip_labels: MSIP_Label_07222825-62ea-40f3-96b5-5375c07996e2_Enabled=true; MSIP_Label_07222825-62ea-40f3-96b5-5375c07996e2_SetDate=2023-09-25T12:57:06Z; MSIP_Label_07222825-62ea-40f3-96b5-5375c07996e2_Method=Privileged; MSIP_Label_07222825-62ea-40f3-96b5-5375c07996e2_Name=unrestricted_parent.2; MSIP_Label_07222825-62ea-40f3-96b5-5375c07996e2_SiteId=90c7a20a-f34b-40bf-bc48-b9253b6f5d20; MSIP_Label_07222825-62ea-40f3-96b5-5375c07996e2_ActionId=0aa9d402-c3a3-4bf3-b0ce-bdf7e5c59046; MSIP_Label_07222825-62ea-40f3-96b5-5375c07996e2_ContentBits=0;
authentication-results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=btconnect.com;
x-ms-publictraffictype: Email
x-ms-traffictypediagnostic: VI1PR07MB6704:EE_|PR3PR07MB6539:EE_
x-ms-office365-filtering-correlation-id: 68180ef5-19f2-4312-970d-08dbbddd2239
x-ms-exchange-senderadcheck: 1
x-ms-exchange-antispam-relay: 0
x-microsoft-antispam: BCL:0;
x-microsoft-antispam-message-info: o2RSalxdXGOc+i4Za8lYJu39/Q7XZSL00a7Vm7jsAQHgIbnBSLpwggjffDnft/RKrdL/UkW1i/BnVNE3PUc9WXzev7sMW+A4Srkv2sNBuVfgj5q6IFIAcikp9lSUE2fyxdx297V67uHpiOaGNnMTtxtVsQwKoiZa4XAnSrZtbPWM+IvD6H6UUxQfM808jW/mdD1wDuerLdK3e5vpy1hjgMfqZigIXYprF/0ruhO2AUSA1tDM2H4po7p62XVwmoXM2H/jgo9yWTYN1L5vN9G2TshwWddi80/9WjfNSXNzMc8czMPprrWO9lRJeMPLR3LA1PCg6ELBbl4+G+aFatm5x/cWajRYbsN/KZeInovsabsDIXI5YObk+/G47OafxgL8D9UuXrBCSLvwrxDUAP4rVi9LhG9bxGw21p1ymrwcuV+STf6aq8fxXotB+NbsD/b5yE6s479mpLOCeqmP0GUjM5TJKDpgR9ADZy5ii+CzO/t7a4JYkwxSoBII5BTtj2HGnpnVKCCneDK2CLUVEVV5fKHUOqfsTBVxhiqHIy8hbR2iY6KyR/li6dInTtmF6UEVO4wrsLf5ScwYdlvyHZHPAqZ4NRV/c6QJhYUuDS2/uJLWt3bouUmqmaMcWOxFTdVMVDI5KTLNnRoBiyMRZaMMY+UM9hqBKbttjjr6PPzctl4=
x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:VI1PR07MB6704.eurprd07.prod.outlook.com; PTR:; CAT:NONE; SFS:(13230031)(366004)(376002)(136003)(396003)(39860400002)(346002)(230922051799003)(186009)(451199024)(1800799009)(55016003)(66574015)(83380400001)(26005)(8936002)(8676002)(4326008)(66556008)(316002)(52536014)(478600001)(41300700001)(91956017)(110136005)(6506007)(66946007)(66446008)(64756008)(76116006)(5660300002)(54906003)(66476007)(2906002)(7696005)(122000001)(9686003)(71200400001)(33656002)(38070700005)(82960400001)(38100700002)(86362001); DIR:OUT; SFP:1102;
x-ms-exchange-antispam-messagedata-chunkcount: 1
x-ms-exchange-antispam-messagedata-0: qA082XfZIJArP+KFwaXfyA5Bvwxsf1aXe/KTI5LUHdU9JjcllQD6cm9e+R6SKdUqCHf/zZzSbSCPF+ON3mW4mpjmISIDWKDx3sjh7oskXPDoG66wSJDCRITKAtwK4OUwfpkhmtyozVMMErEHENrbrJ3XASuCxzYqQRjs1znBF8XjqVGq/EQhd657AzRIArUwg7IhR4VrGLdlw3Gzd3frr39Q7njbcKXJnGGOnlV6OlqXSzJrNr/vqNXtwkh0lT+D9bEbRmxHyjOKylZfbgV7tkYYS2KrIu0+YdLmmt4VQAuMYQAsGYU59QOV89yJ8/0PoLfRw0+UCau0W25Jm90kFUf4ab9R5FPobHmWmPr5XqMe5vkghKBEP7AQXtTSc1HTjM8IkXS2MQ0QobtCCAJl1PSKFYN8T3VwoTM5oJEyPEb2bN2mqNSvLbbFR5Gx1UcactTvIVnJvLYk2XJ5BXdDucLvoo7pfohNPyU7GFpoagSWY5u9S4awK6MfQaaSs/XpNYbjNq3LoHWsQQoFTxdz8jsK0hOobOzy7AAwOsjC+KLeYK+OIp3GbmGqyaYAV+oL8YmPCiVkAUGejKnRKFZ3wufuQ6UkCCkGSxk7yy4AWEXjb5yoNACgtgXY+topqTvU+p7NtL3aAR+oSHpqVp7A/mgBuZj3u/3vLamXKbrQoBAeXoD84uIy8wlKBaJCpcLJ35hMXYM33AOcyaKSRq592Zy/keEqpSiT+9imX5YUaSLAcZeRDgcml7wRiTvRykHl295SSGaIlOP8jWCjwt+rv0ca4nfc+PCSBVN/Hmc3fPbyGXFWeU7tNZv40HMiMQ9W2OCoOR8R2ql2YoloifPrbgeCRE9LnNkV7IPbj2T0Uj3uPsukLLC/fjKbVT5rbwV/jHgyYbuJjLxT4Z4SeXjChtxDrPibfWIdCG+/Q4m/zmTPT9jS11bDYBc1HuenBQi27gt2as1AAHrAoNf7AvRO4spWeG+l+q+2ymRQEHkkRSYQSvUTX6/12xP2jVxANbnzLQRy9clcmS0+/4pmEAIBQEv8GFhyFX5f0608AloVRXFL7pIOQXpZkPigD9dysguCW5KnqmAKQnOwBaohZgN0ZRGuARxLO4fjZFR17Ji7Bfro9HYrf29EfyfphPsLOTbeEqzk3ItcGH23ZlxPjFvNQoFSeiQwi6cuX8df5Om1OLdscVVMH80JXhPsyqeNlMGfaC773obVTln+hDL/3ntfy0oaLLPcBvIwWVVSRm1bQk9WRdk4o4GD3ZGtZJsqviFfB5QxMz4AkF38l0512VOL/c4k5X48IYQUsn7gtT1PuSMZEUxk0cPlFR1MlIYPXoUrFOGqmDSgTYXIGb9itaSK/QkyF9PCq43+9kl4wzLzMEtiILkuuWLExUbDEkzniA+MEgsB4ve8LH/zbLt69QgZ9W/uv1DW4XXbaIbhpb+iSyUkV4OmDW2SEAG5++vbnhKkcgK8EDrVj3GCxVJ29NwzMvvitLls7h7XP2Qo9BeWpeQVgy0fm9stYxV+XY+DgC3Bbr3Vuf/+imd+nfqv6yh+1eJQvg2fMhem7MN+JnLYiOFjzIVAU8t3E82jfl4xCdwO
Content-Type: text/plain; charset="iso-8859-1"
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0
X-OriginatorOrg: btconnect.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-AuthSource: VI1PR07MB6704.eurprd07.prod.outlook.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 68180ef5-19f2-4312-970d-08dbbddd2239
X-MS-Exchange-CrossTenant-originalarrivaltime: 25 Sep 2023 15:36:06.2614 (UTC)
X-MS-Exchange-CrossTenant-fromentityheader: Hosted
X-MS-Exchange-CrossTenant-id: cf8853ed-96e5-465b-9185-806bfe185e30
X-MS-Exchange-CrossTenant-mailboxtype: HOSTED
X-MS-Exchange-CrossTenant-userprincipalname: fyla72FTeOXcmW2HvU+CB+ootCD1caYVVw65V+nygvSitk3a6lfhS5bP5BegZh7oKVbVgOugfWj4XWWRMtAB6A==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: PR3PR07MB6539
Archived-At: <https://mailarchive.ietf.org/arch/msg/alto/XtPfu9DOU7P-jfeqaYodBScI6Sg>
Subject: Re: [alto] Last Call: <draft-ietf-alto-oam-yang-12.txt> (YANG Data Models for the Application-Layer Traffic Optimization (ALTO) Protocol) to Proposed Standard
X-BeenThere: alto@ietf.org
X-Mailman-Version: 2.1.39
Precedence: list
List-Id: "Application-Layer Traffic Optimization \(alto\) WG mailing list" <alto.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/alto>, <mailto:alto-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/alto/>
List-Post: <mailto:alto@ietf.org>
List-Help: <mailto:alto-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/alto>, <mailto:alto-request@ietf.org?subject=subscribe>
X-List-Received-Date: Mon, 25 Sep 2023 15:36:18 -0000

From: mohamed.boucadair@orange.com <mohamed.boucadair@orange.com>
Sent: 25 September 2023 13:29

Hi Tom,

(as doc Shepherd)

Please see inline two specific points.

<tp>
Med
No and no.

I did mention in my comments that 'source-type'  is olny used in the Appendix examples so yes I have seen that.  You need much more than a worked example to have a Normative YANG module, assuming that 'source-type' is intended  to be Normative part of the current YANG module and not something for future study..

Second, the examples do not use the values provided for documentation.    Example values for use in documentation are defined and most authors use them, but not here. (This is a good way to undermine the internet since plenty of users do not know what is meant to be an example not to be used in anger and what is Normative and must be used only as is; that is why we have many RFC specifying values to be used in documentation!)

Tom Petch


Cheers,
Med

> -----Message d'origine-----
> De : tom petch <daedulus@btconnect.com>
> Envoyé : lundi 25 septembre 2023 13:58
> À : last-call@ietf.org
> Cc : BOUCADAIR Mohamed INNOV/NET <mohamed.boucadair@orange.com>; alto-
> chairs@ietf.org; alto@ietf.org; draft-ietf-alto-oam-yang@ietf.org
> Objet : Re: Last Call: <draft-ietf-alto-oam-yang-12.txt> (YANG Data
> Models for the Application-Layer Traffic Optimization (ALTO) Protocol)
> to Proposed Standard
>
>
>
> Some stray thoughts
>
> 'source-type' I do not understand.  The module defines it but it is
> not used except as a base in the vendor example.

[Med] This is actually used in example-vendor-alto-data-source:

      when 'derived-from-or-self(alto:source-type,'
         + '"yang-datastore")';

Section 5.4.1 includes a pointer to that appendix. I trust the authors will update the text for better clarity.

...

>
> Appendix A
> examples should use the values reserved for documentation use
>

[Med] There is no such a thing for the prefix to be used by an example module. We may discuss the need as part of the ongoing rfc8407bis effort.

draft-ietf-alto-oam-yang already adheres to this part from RFC8407:

   Example modules are non-normative and SHOULD be named with the prefix
   "example-".

...but I think you are right that some better names can be used to avoid confusion. At least, the authors may consider updating the modules names/prefixes: s/vendor-/example-.