Re: [netmod] Use XML namespaces in YANG document examples

tom petch <ietfc@btconnect.com> Thu, 10 February 2022 17:09 UTC

Return-Path: <ietfc@btconnect.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 7B0E43A045B for <netmod@ietfa.amsl.com>; Thu, 10 Feb 2022 09:09:53 -0800 (PST)
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, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, RCVD_IN_DNSWL_BLOCKED=0.001, 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=btconnect.onmicrosoft.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 TJ2GXcuQl__S for <netmod@ietfa.amsl.com>; Thu, 10 Feb 2022 09:09:48 -0800 (PST)
Received: from EUR02-AM5-obe.outbound.protection.outlook.com (mail-am5eur02on0708.outbound.protection.outlook.com [IPv6:2a01:111:f400:fe07::708]) (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 3B4863A090B for <netmod@ietf.org>; Thu, 10 Feb 2022 09:09:47 -0800 (PST)
ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=f59DwcdtiOqLUwboqJ8EFdN0iCEo0VN0cMLhsOgDmUDD4+whN5+Tmo+42PnwixkbX6eGng84Cc0AkMSp1Qm5rBAkrHJ8e9UdagKbeHggf6WgCWNXcXCn62FNmL5agxZJ89Brqv+NkU04f+Nu60mzeWNhb4mdqwjYVfqx2/ircIl2blFsivb4tE6M2OXrhhTPVhG+IrXX2EJ0fPNsrVwUvu5trzJEuIVXm/tz1lUP8yWqMzVGZAl5tLcQro6Kk0MfZTyZimQ7yfvIhxmdKfZKl6lBUWXZWMvNNldEEAbMjgXYcgaltfVStQOwdQQV1nK4mKc14WtTtkAiMGmd6VRe2A==
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=6yIKtzhr1aiKAKToLqhRCXClwFfw3ZVcz4x+b+azeiw=; b=jaOl5tajalt2EmvMfz5okDS5y/bQ+HzTUmnnwmHfB9KmXLJwlds2dp13jzDLXjKr4C/EGHscfiLSgPKr0hsFbdYBods5CEZX7fSrLa1bXXYz/f+OLWxOWzeyPcuMitDrtuGuo9cEr2o2NA+DOScW2bl7e+uxQUVoAlgwuvrYhOCxS0rYPQfpy1E4LnJkLsB6x1bIA0jtm69yukI7Xoj+uC8l+VnMDey335N/Enfx0jYJLYs5sIEdkCA0fPlVaW6aSO07tqIpv9YAFRKDu9M6ssKgm8MMdcsLK8/Z2yJEBb9PX6PtVKnMlR3uCyZhOs9K8aQn9r6cLAdP8RhuZpzAiQ==
ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=none; dmarc=none; dkim=none; 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=6yIKtzhr1aiKAKToLqhRCXClwFfw3ZVcz4x+b+azeiw=; b=fTgqSCbkW8HJujnNgplyisuJrEaHoR2Rk6UYiDSm2mRNTFghWp28dIYQtBrIAA7KzTPzPvYSPewJLJKJqCEikY+dCd8hBMm92ARyt64OvGeFqB7rqJfaMalNsQWm7GhR0sEuFJY3PhyJ+Wi6++ZPfQc28nxq6nt97Rf7VbD4+bQ=
Received: from AM7PR07MB6248.eurprd07.prod.outlook.com (2603:10a6:20b:134::11) by DB8PR07MB6345.eurprd07.prod.outlook.com (2603:10a6:10:137::13) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4975.9; Thu, 10 Feb 2022 17:09:39 +0000
Received: from AM7PR07MB6248.eurprd07.prod.outlook.com ([fe80::4fb:7a5:68d8:a33a]) by AM7PR07MB6248.eurprd07.prod.outlook.com ([fe80::4fb:7a5:68d8:a33a%6]) with mapi id 15.20.4975.011; Thu, 10 Feb 2022 17:09:39 +0000
From: tom petch <ietfc@btconnect.com>
To: Carsten Bormann <cabo@tzi.org>
CC: Juergen Schoenwaelder <j.schoenwaelder@jacobs-university.de>, Tim Bray <tbray@textuality.com>, "netmod@ietf.org" <netmod@ietf.org>
Thread-Topic: [netmod] Use XML namespaces in YANG document examples
Thread-Index: AQHYHFqbtWVJ4yLJbkequbdkAxANeayIgrkAgAQzQquAAAjkgIAARQZy
Date: Thu, 10 Feb 2022 17:09:39 +0000
Message-ID: <AM7PR07MB62480FC33CDC9A1FA31CFE26A02F9@AM7PR07MB6248.eurprd07.prod.outlook.com>
References: <CAHBU6is235QT3d7q+0xhJHdtVna_9-qjGzHG_P4gnMd6nKtdTw@mail.gmail.com> <20220204.081841.166197909676487568.id@4668.se> <866e763b-88ce-ca3f-300a-7f702467fe7c@mg-soft.si> <20220204.161536.1816358672148417997.id@4668.se> <5BDB40B2-F191-41BC-92DF-BD0A94B6E992@gmx.com> <20220207200304.qhkvwrxwl5i56qqk@anna> <AM7PR07MB6248E7E96CBA846EC59C2DC4A02F9@AM7PR07MB6248.eurprd07.prod.outlook.com> <B30D2207-BE27-4E68-A9D1-3F17B0154345@tzi.org>
In-Reply-To: <B30D2207-BE27-4E68-A9D1-3F17B0154345@tzi.org>
Accept-Language: en-GB, en-US
Content-Language: en-GB
X-MS-Has-Attach:
X-MS-TNEF-Correlator:
suggested_attachment_session_id: 11abfae4-5e38-bcd8-dce5-5ac7d1cb220e
authentication-results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=btconnect.com;
x-ms-publictraffictype: Email
x-ms-office365-filtering-correlation-id: 3cc780d0-5568-4c48-30ec-08d9ecb81fa5
x-ms-traffictypediagnostic: DB8PR07MB6345:EE_
x-microsoft-antispam-prvs: <DB8PR07MB6345754A9C2D7AE0263EECEBA02F9@DB8PR07MB6345.eurprd07.prod.outlook.com>
x-ms-oob-tlc-oobclassifiers: OLM:10000;
x-ms-exchange-senderadcheck: 1
x-ms-exchange-antispam-relay: 0
x-microsoft-antispam: BCL:0;
x-microsoft-antispam-message-info: AIAnR0jUqwJNI0ov4e7G/5bonmTvH0frBCLFyywtrz68WP361pJikBXKmm0wM/0g/6TzC4r0vvnB5m07/eKdNga/fXN+M7Ayv5I4QafD1r2FNNV9adl0p0e+WWEUE0vuN1+F4kTn6DnNmDegIQ63EFJQRgJi9JrYhnMeNFmyweAXogryVhieR2GBOLfpw2+oLNEI6rcY79xt2TZEjKa8teDGwl8HTSz7PYL0n3xKwR+qX2UP2KydXKt0JNKu2yto22/s33oscFd0tRMv51A35ws7y5Ffpek71gH9P63p8FO/s/Osp3mBscpVXwM8Vzy4rNmWY7X64SxjCokVTTqgtYyVnAa7mMkxrw/Ct2Tck6Zg8br1cZOFe2T1o2HQpIrOPsInKeeSedyjZXskF3LMDUAkGlvm2lwIBZ1ZzjnYog++z967aaguiDCtaEdRIzEz6hUfBbRroF0bFaVwpRMKNVq0HTbN+suWMHZP3Kch2tzmnbbGC0LiUZ24ls/D3HOlXb2FI6mTSRb870kkfQCKnTRwi3dUlFvtL1HNfxwN8TriK/zTyZTgGn1pJmmjE8GHSPhyjjNHCGT1uBtpEHm42ICOlmXvvrDasHYq+qsuTuU1+Q+hLxGHTDatgx+2HRkAnV6s4T19c8fMTOwNZFBW+e5uEmgWnrzUpoJAvYU/j73t+CmCFDBcOyVmXpjYOwIrBJxoOob4GyIMWbLMSZoD8w22tb8p4l/zta4V+RgQ2G1WG2vPBNHQz8lMADEPzzrD
x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:AM7PR07MB6248.eurprd07.prod.outlook.com; PTR:; CAT:NONE; SFS:(13230001)(366004)(8676002)(33656002)(83380400001)(8936002)(122000001)(66556008)(4326008)(64756008)(66446008)(66476007)(82960400001)(186003)(38070700005)(9686003)(71200400001)(6506007)(2906002)(7696005)(55016003)(53546011)(86362001)(316002)(38100700002)(91956017)(66946007)(52536014)(76116006)(6916009)(26005)(508600001)(54906003)(5660300002); DIR:OUT; SFP:1102;
x-ms-exchange-antispam-messagedata-chunkcount: 1
x-ms-exchange-antispam-messagedata-0: tKjk52+LXePegcpsjzXw3Eq4Gh5q/rwzLOm1uL2cWwVcTko0urVFU6pFxXWGdjwPQEvWkOi5Spok6U6BY0VpOP0IlilXoLCU4m6cuSAovq97IntNwpQOdNeHWmRMQiNykIa+363WV3Xf6lqgFdX7bjHwOzp9D48+QwhwIHZdgJw5NHf12uZMNWu2hUAvU3z3Wmxl5tUUocZn9ZGY7oPR4expswUxaUZRCMY/Qu2AZB/IIWgmdGZgEi0nOgtX4DeT3F6RU2PvmpGe4Ehh1T8jegV15kWNUkTfe+xSuT6jn9f71ytUZGco5cR1RCfKPcsR4yVHCugdfWWdNdcORoQ5Y67UeRyBrBKgeiP0sb7aDcwxxcHBNpgN09um4cFEgE833+ujpiz3LTW6aZfkqSe1hooz5WB2rkCAYXN9NP5WOF2kUc7dFhhQy+kyFCQ6asUqkysifYAx6tLAaxztj0Egv6xTDzXrMeI5QMEH4NrdEyVVkY7SOUzxuvkzwKge8gIa7hKDHVbXDSaD+VfiVezjSq+U7cKNIczBMUO8tC/Z5Jo/sPTzNeM3i4b3odLtI52g+ZqKCw/yaQjr9n6APg4CEpNgNRQuQWdD67Gvfnkd8W/glvTos+IQQPke36RAwVFAWXBwRBR/P/uHuTDEAnA+rM36DqSrpx5sUxgtfeLUUXkl4nzNAAFph/NuGgtd80f6bEiuRMlPZXwLNJBmeY0jhtA7az/G9OxOr93AuOWgZW8m7zzdld2o2P5/ez8HxnkWaAd+JBvkskutDXFMz0q5oTccRyvr5AkFomiqLSW/9UNMdMMHyyc798Ot9oKIGhe0s1qqdphetgIfDG0+dMO2r6rzUHgCEyh4LApzMAJumdzaBu6avP7lk5RAFEncvpEv/zI9mqnHfoXMs5L5RtibDqEysdoPYTLJuzIasvuwzZ+CkR8CR5HVOJn4AAW970Y74D4xQemtvP9eynNHE2g8JYA6puMYzkEe+H/2PyVzidrdL6tmgIEyIOYGe3XDqg+b6hUHL+uNAolxNQ6TVNVOA2BbhhshDUhhFm7jgaIpN2qZgbE2SjCzrbm20jLlSMjjFB8saSoXxFThqGUe93WVgbrDMsmlF9NQ9gMb4exSZHlODBWfWCWuOfr/cWymQjECSTsajGKjaLS3NTpwUqgvNEBcZrp9FQNsWBCuNu6yUxUKYq1+oGDohrDcYnU7sYoHXxkSddsSd9xh3FjNjnLS5hqnN1Z8Y8lN91URhgQDbu1JtQ3NRnJV3php4viSk7xzox0n8B1xkDuGpiq+NFfj69NNii6+J+7HOQD6Ly2zGJ3YJ5tNHXQa3cWy+nQHn0C/LAET0PBCL+6AAiTIPbPX1yY0Hx61AYXruHbPv1ovzGjHLRNQAGCSxoqslPjEHg5LvH/+hsLrlts/tLn6T0Nj8aEDlU4FqBNw1r7cMJt0/+kvKQatTtdks2GfTzPCkH17c/+qFhibFsudPgQmuHlnE5hZI6N+GoiQrOmXBnOsBSu6ztC/GLNht1+YuiC7L/0RS3xOckMIyxhfrlcG8xK9g643mtJAK7p/yPFCwnvZlK8akl+U2KxvdzFoyQFh2Hhxm7WnBHLfPs7zlG/R+Bv6+g==
Content-Type: text/plain; charset="Windows-1252"
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0
X-OriginatorOrg: btconnect.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-AuthSource: AM7PR07MB6248.eurprd07.prod.outlook.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 3cc780d0-5568-4c48-30ec-08d9ecb81fa5
X-MS-Exchange-CrossTenant-originalarrivaltime: 10 Feb 2022 17:09:39.7131 (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: dFz/D1wRM41z4QN6QX29PyaWhNiqul0Gev7i7vJV+j7ZQetfCSkJ1IZlZM3YwJWrIBxYu01ZLZJXyempLANYoA==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: DB8PR07MB6345
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/orQ-NRXxCzKVkDs4nh6i3qgEcrI>
Subject: Re: [netmod] Use XML namespaces in YANG document examples
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, 10 Feb 2022 17:09:54 -0000

Trimming the cc:

From: Carsten Bormann <cabo@tzi.org>
Sent: 10 February 2022 12:43

On 2022-02-10, at 13:22, tom petch <ietfc@btconnect.com> wrote:
>
> If the comments in question had been made at the time of RFC7950 they would have been most insightful; now they are not IMHO.

The comment is insightful, it is just not about this document.
I think we need to be able to sort comments into the right bins.
(And we need to formalize “Hold for document update” bins for non-errata.)

(I’m also still not sure I’ve got an answer to my question about using inconsistent prefixes between YANG and the XML example.  What is being demonstrated here?)

<tp>
If you are referring to
" Is there a reason to violate the SHOULD?"
I did not see that as related to the thread but thought it was answered anyway by Juergen.  As he said, the SHOULD gets violated when prefix clash which, in the absence of a registry, a namespace, for prefix is possible. Within the IETF we ought to be able to avoid clashes although good hygiene, like not using two letter prefix helps but there is a world of YANG out there most of which we likely know little of.

But the thread was about where prefix may be used and Tim was proposing a different prefix  in the XML content.  XML defined a namespace for identifiers using a URI, which is clunky, so like many specifications, a short form is created, the prefix, with a mapping thereto.  The question then is where is it permissible to use the short form, where the mapping will be understood.  I have not looked at the language specification lately but the quotes from it in this thread suggested that it is ok in entity and attribute but not in XML content and needs redefining there except that this is YANG and this is identityref and any parser that does not understand the nature of identityref is a lost cause.  

But that is at the limit of my understanding (until I re-read the XML specification).  I am clear that I think that we are ok with what we are doing and should not start introducing new boiler plate for future examples of YANG.

Tom Petch

Grüße, Carsten