[httpapi] Re: Orie Steele's No Objection on draft-ietf-httpapi-api-catalog-06: (with COMMENT)

"Kevin Smith, Vodafone" <Kevin.Smith@vodafone.com> Wed, 11 December 2024 16:47 UTC

Return-Path: <Kevin.Smith@vodafone.com>
X-Original-To: httpapi@ietfa.amsl.com
Delivered-To: httpapi@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 7633AC15108C for <httpapi@ietfa.amsl.com>; Wed, 11 Dec 2024 08:47:37 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.105
X-Spam-Level:
X-Spam-Status: No, score=-2.105 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, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_BLOCKED=0.001, RCVD_IN_MSPIKE_H2=-0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, RCVD_IN_VALIDITY_SAFE_BLOCKED=0.001, RCVD_IN_ZEN_BLOCKED_OPENDNS=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01, URIBL_DBL_BLOCKED_OPENDNS=0.001, URIBL_ZEN_BLOCKED_OPENDNS=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=vodafone.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 TsFYtADAGGjQ for <httpapi@ietfa.amsl.com>; Wed, 11 Dec 2024 08:47:33 -0800 (PST)
Received: from EUR03-VI1-obe.outbound.protection.outlook.com (mail-vi1eur03on2084.outbound.protection.outlook.com [40.107.103.84]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange ECDHE (P-384) server-signature ECDSA (P-256)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 5B6ECC180B7E for <httpapi@ietf.org>; Wed, 11 Dec 2024 08:47:33 -0800 (PST)
ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=o3zPbT14+mU4B/F1W5cA2lCwjZPxMMq5weCEKkCMR4KHv/KYwV8A2dVeUzHG9ctLaxmugVSnBroaNAAJgN7oQPRa9iEl3pcggriCF3+KepetdQgLVYYIymB2AFiSyrKxLqyTDjtXQsraVzhlSyWPOpRsooWMIODCI5/HZ9sHnn9VMs3qX87w2uEmMkCgdQYSL0FO+WVuhlgA5TBCidvKjFjncTAM5EkjrBFYOWtsXQKgn+Gf7J9LfLX0joG7shlwRFLRk/ZSFTBV7+l5C9lglQdHSsI+sRb4daOHVoAnHxUFO/ZLdGtMVfU3YzmscQlKmEACDUM5XKCFGuGEux1UlQ==
ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector10001; 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=9bl8mXr1PVy5mWe4mQgVMCR5OLf5uNUP/bXekf9AoFY=; b=hkuGhrr3ocThWGu3K2m7e9/n3sIGWvqtfhdZ/u419YOyvNxp8yIAr31lA7X0PPv5keYcHzrcoQAB2nFotrI9nUL3Dbi4THEkKqk9zEwN5FEK8TpFMcFjWp1K5hGdvAIQ3qTVHDFOdhdPWJUfBkCrHJGmzhuJMNFmjEbriOopjjEnc9Acdx5xaqhXiLlMlnjxupUgkA7+E8DwP8MTnnsG5OMOT16GF0NAU/7E2avdJN23D8ZStJ283kVoMuv0R8J805aRmmwohfFwb+nLr1CMlRsAxyuGiAOCXZ5b0Q10h+ptrTZU/FfKPCjUQySGRlhkIH4/syJJ3EcGYPXbS+cGkg==
ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=vodafone.com; dmarc=pass action=none header.from=vodafone.com; dkim=pass header.d=vodafone.com; arc=none
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=vodafone.com; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=9bl8mXr1PVy5mWe4mQgVMCR5OLf5uNUP/bXekf9AoFY=; b=PehM4j79BueyZu7tM84ZVIsmMMxAVo9pyuEPMbFeNuknUrpzmCayBOWTm0h6OQsiflQBc0vmck8/Qg0VymF2s5cCdDxo5DaPv52ImEN/VXeuZXS/I2ogFE636DnwdtUpTYCJzZvXZKPf7+6Gqei0Fb6/oOnxeeeQ0IDSKuN0/5JV2HQiA46hCqHOMmGagD/UVKOt6XZt0FyVCZtXCbxogc92ceMFWa8xeTiZ8s4PKJy/ArzMmf42s+FG6xVX8bcO+/RbE3xHZkdfKtpDQGkeJ7VNWGM8ws4wHQKqzQgLR0NF9bsX4xyt4cO8R82bwgdzNfAK7w/CR+zq0M1QU/v6Kw==
Received: from AM8PR05MB8052.eurprd05.prod.outlook.com (2603:10a6:20b:354::24) by GVXPR05MB11589.eurprd05.prod.outlook.com (2603:10a6:150:227::7) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.8230.19; Wed, 11 Dec 2024 16:47:27 +0000
Received: from AM8PR05MB8052.eurprd05.prod.outlook.com ([fe80::3382:8748:39bf:2aaf]) by AM8PR05MB8052.eurprd05.prod.outlook.com ([fe80::3382:8748:39bf:2aaf%6]) with mapi id 15.20.8251.008; Wed, 11 Dec 2024 16:47:27 +0000
From: "Kevin Smith, Vodafone" <Kevin.Smith@vodafone.com>
To: "httpapi@ietf.org" <httpapi@ietf.org>
Thread-Topic: Re: [httpapi] Orie Steele's No Objection on draft-ietf-httpapi-api-catalog-06: (with COMMENT)
Thread-Index: AdtL4nbXbQkDKDY1TPeLAE3P+Xjgnw==
Date: Wed, 11 Dec 2024 16:47:27 +0000
Message-ID: <AM8PR05MB8052B9E9FECF50F0B0B07528913E2@AM8PR05MB8052.eurprd05.prod.outlook.com>
Accept-Language: en-GB, en-US
Content-Language: en-US
X-MS-Has-Attach:
X-MS-TNEF-Correlator:
msip_labels: MSIP_Label_0359f705-2ba0-454b-9cfc-6ce5bcaac040_ActionId=895ff1f6-df59-46e2-83a5-1340b30727dd;MSIP_Label_0359f705-2ba0-454b-9cfc-6ce5bcaac040_ContentBits=0;MSIP_Label_0359f705-2ba0-454b-9cfc-6ce5bcaac040_Enabled=true;MSIP_Label_0359f705-2ba0-454b-9cfc-6ce5bcaac040_Method=Standard;MSIP_Label_0359f705-2ba0-454b-9cfc-6ce5bcaac040_Name=0359f705-2ba0-454b-9cfc-6ce5bcaac040;MSIP_Label_0359f705-2ba0-454b-9cfc-6ce5bcaac040_SetDate=2024-12-11T15:36:36Z;MSIP_Label_0359f705-2ba0-454b-9cfc-6ce5bcaac040_SiteId=68283f3b-8487-4c86-adb3-a5228f18b893;
authentication-results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=vodafone.com;
x-ms-publictraffictype: Email
x-ms-traffictypediagnostic: AM8PR05MB8052:EE_|GVXPR05MB11589:EE_
x-ms-office365-filtering-correlation-id: 6f2ebd7d-dd25-4a13-833c-08dd1a037f28
x-ms-exchange-senderadcheck: 1
x-ms-exchange-antispam-relay: 0
x-microsoft-antispam: BCL:0;ARA:13230040|1800799024|376014|366016|38070700018;
x-microsoft-antispam-message-info: WEviR+hvku4m+zLpjHA/a2vh4s5Z+DpI0kWckbyR4zglF9k83UMmcIGLSynl4Digh2PO7A2JVBOENwKJAMxTi+HwwLo885i3U9OQjOK6+cMQcZLFcWkomoEUn5JyZe8mSLbJ/CB8hduFxD6ENPmvU1UlWZU0tD6H2E91gvqPaiRNMqiM7kTtIqRshNgqt1hOzMqv02QuPip0ggTEjJKj+jecuyN0QeNijCrEDqXA7WqD1Ij8tZmkPjCpFqF5FaG9Lq5yktJDwqQ9L5SsR2eyyq2qV4VxfReMIW2pjFwUhLmZpTSfbrhx2KF514p8S9ov+1wmz3uEdzFMILF5yLxKI1lQ27Pj4UZQPgK2pRupO3CqCAQD4RPfRcqf58bWqaazIYxSlJN+sEszPxmjiHzR5Lb7i8/U1xFRgDnPCc8i2KN4njPSLfm3LJRq94NaoCnAn9PAlA0VnaHabBnmB+Z93H1vRat1V0W6bI/kmQOlDxULTUnuB8G51ujDX5704Vy+ttdf8ruvhjMHM3uZJHLE9ajs8fDqr0IMCVcgLFxNL17bTwTRWtJtiuDTG3XXB5nrIoNGshnd71WwlMdyqrNw0F0Va1rUW4FHqyumwgjhiurwCltK+O216+9nYM2cXV/QLQg+hvwt47xhLY+/wJugtSFqpOFKf3deClRH2SG2OL3k2PtZH5siKw1OdQ8l3l+GCkjK4T7hcLYNw0g1VwbKHru9fE/+BWKAxqE12Ebkzle+3fPjHTeVjBn19ACT8+9kqQ35JXWqRz+gNxXAtQLAc/YitEaWvMp8BlXk09N0of+Smmhm9keWre7vqF+WGyXjdrkccSmLo2+RCM5EL5XPPvF3SGRqIjlUhqQS2an8031UWaVsU9Y2tRq++b9EtuM/D0/A0j6iV2p/zwVic56mo5FFihYUCo+V0Ry5eWVh8DPWj0MNTXFy2ZkaPfT0n34yHEPMiCklTR3KetWyr1b1kH9i22f8o31YbZZqCOCkg0MJcm5i360JbjUGttP7WYIjrh0GHIfinunXrP15jmkCgrVxrVe1gAkYb3Orot6b1gwfa736gXc43NaCwG8Ti4/ta1KQ9VepejnnFm19rbhR5g5h25y9FnzyTjKhkASV2n/WeT36ewZfXqeqZgcqjrmC7N+SV70qQQyWoPbWWjfzx75o4B3pEAKq+ozYM5iJK81xPj//WY0OWW0rGOd/A1RnCELu3daKHg1UdN3p4PqYr1Z9draFFJYdTg9sRqOrRz5KV9EYziT8mRyv/skC758qiflK+9k74gngjCkoB+24QJETLf9VgwWFCLS5CId1H0r+O2nc/6O8A0KfwPi50bz6tzJ1kasdfpv91qY2FbANb1kcATIisArhhEqI0qpZ7WXWt5g02/KLfD2E1M4d6+oPeHirFPUsU0LlM//QBk2BXA==
x-forefront-antispam-report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:AM8PR05MB8052.eurprd05.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230040)(1800799024)(376014)(366016)(38070700018);DIR:OUT;SFP:1101;
x-ms-exchange-antispam-messagedata-chunkcount: 1
x-ms-exchange-antispam-messagedata-0: eroa3WR/bwxknas1HT4RUXCDUHFVwjsxsXtuFPVg7Ij6LTxBqz4u1lRIieZnT5uAWJhReyv0DfoJfyR0oslG4TWz7A0nvlgl7a9yEXDSifVO223xXXkDrcfSUYQTlpfynm1vXcBpC7n9ap0lKk51aWcyhBD+CzTKpQlrV8QXPjvqYT59ESPdCj3JlyB5Vg7yImNApnYv4ptrsDNfuXYmwa8+ztVvtI0GXZVVkoWC4VdBBK07hxBpuqLgsQ5q3ftSjk7JeO5rP4bfWdNGcwBJfeXFrP3ck+8QI1xH1QdkUp7Ln6QQfQ16SmTE/t8jgMWzfRA9er/2kjzN6EiFN9I9RnVY61yXfVw9cLDqniX+vp9+3MoioGDP6fY+9LpxKDeAzK5ZN3Vv0Wc1yUoXJEkmRdW7vSm8RpSIQW9xgeV/2FgU/9YWhWj/g5t5lN7Y/Pwc/39gtq+ApdQPejS7V6mvdiq0TdmEbpyjJ8QMugqjasB+QpTbu1lHVV2Ac1b39zy9Ej9m3mPemfYu3gRVGmf/5taMFVxJmKUlE6w4GC5XFKqNlNAKa70gKXJKukijSDS4zM6BDoxtCeAXWqb+70wMNM2IiY5MJNCYk4nRy+5vdjFaNE2uhVbmOc7RA31ZXb3Tmytzf96FqExb5haKHHVrcfS3Nsil2HA4tWsF6sXYtjI3ULwzKysZwE53oTMTR+uMzsa3s20WaEasuB3eDovRsQUCBMK/FyK0FbSXq5nF7gWasP/hvc/fWYuiiFTZw5T9YoZKsT4V4M5G1sVm6ZZjD5YuLo15CHFRKiQoidEFeOXK0P2/NXT6K3T3TBZEBm3bfY1j/jT1f0on5e6KGS/EXH5G/lK92wpHynXug0GLeJOfABVeqnl/4kwJ2Km2cX9jwwFDcognwCch1OEr+nXh0IrPvsEP5hYim8cRI9vkXLCV19ho1HhYGGtdKiaJt90pWC7Tp5xpu4Ts7I5RRMKbq+rinOavJKJdQMkzZiZ3UHRb/Gn2RnpjUKVPLatruqwaqNVi4PCK0cPq3CosoXuktefJAOtBj50g4RbiV4t7Vi8ARBZzZ5R0CgCBCuv+3J14O4FwRqaLgKUtnBceOJDuUqxIgBSiOp024WT+PHeI4SbDoi1owPtxdh6cwGn5GcZq8XZpJEWndljTOxi5QrmEVMBadWwkYxW2ZtSEmOViENKHeNd5LJGSK8TiA59ND4DS+kzMWBi4PMN8cR0BSXParYbWm+KLSi+PuQNMbmcprLQyW19b5oVR2Gu8VZHy6gBSQ4Mn0GvuYMxEYxenwBLaLYSiHG5V6VWpxgnqq4dgG7JzloG9+nYPDvC0vvHNPG1G05EcXSRA0NVXklmegoRIDpLUEgaZM3khb0C5Ka9O/Wku9ZGGr/zSO/szh/DgRDq3geQoGwcZexl9HfOvhg6M5Vl76DKUU+eXubCkSCU312kDnvXKWlrVXA9ZvrMygHfacCmm8uEDBTLckl7M1KwILpAf5uLMEpBw896fMHIFb054XNGfxF1UB5BH2jQ7BllrgFJmUgTA3kRPL5TJsI0YDegmA8J0YrxrGnScRaShLZ0kttTJZRWmWCjhDee1APiP
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0
X-OriginatorOrg: vodafone.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-AuthSource: AM8PR05MB8052.eurprd05.prod.outlook.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 6f2ebd7d-dd25-4a13-833c-08dd1a037f28
X-MS-Exchange-CrossTenant-originalarrivaltime: 11 Dec 2024 16:47:27.6681 (UTC)
X-MS-Exchange-CrossTenant-fromentityheader: Hosted
X-MS-Exchange-CrossTenant-id: 68283f3b-8487-4c86-adb3-a5228f18b893
X-MS-Exchange-CrossTenant-mailboxtype: HOSTED
X-MS-Exchange-CrossTenant-userprincipalname: 4qxIBj72ti1eAc2yPyKDQLXY7p1zyYru7spusoGfyiZ83hDBDva/k5JDbw8eATYXJv7A7jFI/7fmpO0UdPg1sk2sqHO5VcYzVKDjnvl62Oc=
X-MS-Exchange-Transport-CrossTenantHeadersStamped: GVXPR05MB11589
Message-ID-Hash: I7EJBKGVVFGDJMVBLTRO6TLSCXOYP6NV
X-Message-ID-Hash: I7EJBKGVVFGDJMVBLTRO6TLSCXOYP6NV
X-MailFrom: Kevin.Smith@vodafone.com
X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; emergency; loop; banned-address; member-moderation; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; digests; suspicious-header
X-Mailman-Version: 3.3.9rc6
Precedence: list
Subject: [httpapi] Re: Orie Steele's No Objection on draft-ietf-httpapi-api-catalog-06: (with COMMENT)
List-Id: Building Blocks for HTTP APIs <httpapi.ietf.org>
Archived-At: <https://mailarchive.ietf.org/arch/msg/httpapi/ftWEGDk06nIjdHRXqp7YTxU-AWA>
List-Archive: <https://mailarchive.ietf.org/arch/browse/httpapi>
List-Help: <mailto:httpapi-request@ietf.org?subject=help>
List-Owner: <mailto:httpapi-owner@ietf.org>
List-Post: <mailto:httpapi@ietf.org>
List-Subscribe: <mailto:httpapi-join@ietf.org>
List-Unsubscribe: <mailto:httpapi-leave@ietf.org>

HI Orie,

Many thanks for your review - I've incorporated fixes for the comments into draft -07 [1] . Each comment was allocated a GitHub issue and grouped at [2]

In summary:

Use of SHOULD  -> fixed as part of Murray's review.
Informative section with BCP14 RECOMMENDED? - > removed RECOMMENDED.
Data tracker link -> will be fixed during IANA's editing.
"why is HEAD not mandatory"? -> it now is.

All best,
Kevin

[1] https://datatracker.ietf.org/doc/draft-ietf-httpapi-api-catalog/
[2] https://github.com/ietf-wg-httpapi/api-catalog/issues?q=is%3Aissue+is%3Aclosed+label%3A%22ART+AD%22

C2 General