Re: [httpapi] AD review of draft-ietf-httpapi-yaml-mediatypes-04
Francesca Palombini <francesca.palombini@ericsson.com> Tue, 21 March 2023 09:42 UTC
Return-Path: <francesca.palombini@ericsson.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 B9F2BC1522B9; Tue, 21 Mar 2023 02:42:07 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.997
X-Spam-Level:
X-Spam-Status: No, score=-1.997 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, HTML_MESSAGE=0.001, HTTPS_HTTP_MISMATCH=0.1, RCVD_IN_DNSWL_BLOCKED=0.001, RCVD_IN_MSPIKE_H2=-0.001, RCVD_IN_ZEN_BLOCKED_OPENDNS=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001, 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 (1024-bit key) header.d=ericsson.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 u8ONwK26SE3M; Tue, 21 Mar 2023 02:42:02 -0700 (PDT)
Received: from EUR05-VI1-obe.outbound.protection.outlook.com (mail-vi1eur05on2075.outbound.protection.outlook.com [40.107.21.75]) (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 45474C151535; Tue, 21 Mar 2023 02:42:01 -0700 (PDT)
ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=VVYB15aoz6dIASRYqkRx7HZ04jLs1Em+PdLNss5zs4tfPb1ORSZ0vOunBiJkgBCibkRDJYWE0lpxsmxmyCq/4BTa4RzMi2aqf0NnfWmaKt5pQooIkcEwX1rIBuEIW1UIihAAc8qQwBRKLJ+27j++4Dh03WGavhpJ7QEBIBB87DUKdm2+Gh56WrrZcbpY9/yO6aKGdQFVfmkbIkEtJUv6SVcwzHNYRylHcbn+7nRYRS4LZGpKX5cA2E4XwjeapW9+HjsatEzB/5Ci8Z6OJlQ5yTKVKdLEblYIVwmL1m7ArB4LBOS+gKgKYY0NKkgsMJIDF9uJGwIVoHh9V2dQBGRcuQ==
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=BMnPWOvxhh622BjOm+LA7Y1nAUfg22C4Tsmo9hO1KIw=; b=JzC/BrzWQ4ON3fgWbc8b1R/etI8lyDGCUxkFC9q9ZCWdZW0SdAtYwurWqCSISkVDFNCGyq/wZ0muqRVN9uLlCETQ7pT/jUFfxwvjmS4EhZS2Maw3gvFP8yVAfnkppDRDQuecwt9RGGZdmpZeCOgQ//+7Wd6fCYOZ8hXsqTHf44yFvriq0lR3Tdj6fgtW+ZNYi3gTVrbGRLxJcHlpi/ZFmGWz39GQwwtRVKIhnS/V9jTbBuUxEV21MId4qeEii+gYONu0AC6sSnJAUb2qBMExwoc5FE+ifV6o7P6/R2nnOVKZNnDG+BE5IffqwQ8oR7XLMjF8rvU9JRztlHJwKjqCPQ==
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; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=BMnPWOvxhh622BjOm+LA7Y1nAUfg22C4Tsmo9hO1KIw=; b=piJtxG6OPGtyLumQT07UCUobDkBrOmvaCdJDVuBxDHBJM4+E8KzPlfjRW1Zx3gGZ72kN+lF1Y8tz+agQyc73kFq5l/+VcC/5fbW/CB7AQTJVXPgbJ1mL2BX0DU1rJ9ZUcfieqT6mhFJlUZ22MPj7K1qTvyhZrQZiRFTMjpuaGGA=
Received: from AS1PR07MB8616.eurprd07.prod.outlook.com (2603:10a6:20b:474::16) by PA4PR07MB7309.eurprd07.prod.outlook.com (2603:10a6:102:d0::23) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6178.37; Tue, 21 Mar 2023 09:41:58 +0000
Received: from AS1PR07MB8616.eurprd07.prod.outlook.com ([fe80::8614:9aef:37f9:db1c]) by AS1PR07MB8616.eurprd07.prod.outlook.com ([fe80::8614:9aef:37f9:db1c%9]) with mapi id 15.20.6178.037; Tue, 21 Mar 2023 09:41:58 +0000
From: Francesca Palombini <francesca.palombini@ericsson.com>
To: "Salz, Rich" <rsalz@akamai.com>, Darrel Miller <darrel@tavis.ca>, "draft-ietf-httpapi-yaml-mediatypes@ietf.org" <draft-ietf-httpapi-yaml-mediatypes@ietf.org>, "httpapi-chairs@ietf.org" <httpapi-chairs@ietf.org>, "httpapi@ietf.org" <httpapi@ietf.org>
Thread-Topic: [httpapi] AD review of draft-ietf-httpapi-yaml-mediatypes-04
Thread-Index: AQHZW16bxwJzkWOWhEGTTgg4Lysxf68E+TJa
Date: Tue, 21 Mar 2023 09:41:19 +0000
Message-ID: <AS1PR07MB861696AA62E3EA3BCDE1815498819@AS1PR07MB8616.eurprd07.prod.outlook.com>
References: <0F41D472-D142-4712-BC1D-2145E29BB4FD@akamai.com>
In-Reply-To: <0F41D472-D142-4712-BC1D-2145E29BB4FD@akamai.com>
Accept-Language: en-GB, en-US
Content-Language: en-GB
X-MS-Has-Attach:
X-MS-TNEF-Correlator:
authentication-results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=ericsson.com;
x-ms-publictraffictype: Email
x-ms-traffictypediagnostic: AS1PR07MB8616:EE_|PA4PR07MB7309:EE_
x-ms-office365-filtering-correlation-id: 2fe837db-7a54-4dea-8310-08db29f083ef
x-ms-exchange-senderadcheck: 1
x-ms-exchange-antispam-relay: 0
x-microsoft-antispam: BCL:0;
x-microsoft-antispam-message-info: 1ufPT/xAk+l2w3DvZZ6XgbFy+QwEpiQxIw4JYdp3pAnHV0UdVV1E0u/A2A2pYaCm/WL8+0b3LMD2PYV4wBR+IwS1cdfzqWOBysoyzouf5W1h0a6dw4ZF/1o9L3YvZJPi4mOa892xqnqfhvRU2rN8ud/sqv9KRrvCzwwfJglZBqajrNVroN2SZFQU4KDztfXNRnw8wwtaGn6aL2EsZXz2pStr3ivN4mHiDbaL70wyXBujsmELF5PC6gfxvvZUYgWU8BGxSyV343xWi+t4d9wj7VZxARHqfDaKDUVhYO3gR+FWKC0BtiDkDqqM/D269Dg+vdQoLuqY/Z4xv1QAEr+KQGRJZqurAQ8gEjtY8jAuP8cqErNe2dF1q0zy+L5sbDnDwhACVX93oEF8CAjaBEKjiq5sWDAPEGIbjkhaDFf4j9JbdjgX8uCi2XDTtAQWGZiYO2cH/jlw7wNp/FgkzWdbtL4F3oAFoc0xSWCCevEF+p5p5oeeGkuqiVFarSWWABAlueE8SrotEmaM/e/+UiCkAS/DAyFP4mYk/zqWK547V0RmbxWt2ADrkMqjJQuqw/R/oqhAEWQONOpPuPi4P547J6wCOydU/bzDTvZ+HfYf1eWkMZFNd+tUKSqB+kLX+V6emcfCWKHZWOb6N2R7MkXov3uoPlja6odCYXishxgR/CYldqZEZOs4NqkHQkC73hlZcTceBR0p3NeGjKxsviZIg9iZwEqEGI8GPJrdHoTRtVSSJ17jzhhQ2JeLctmMC6/G0y5sWs9mgtLcANZGt6ZCKg==
x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:AS1PR07MB8616.eurprd07.prod.outlook.com; PTR:; CAT:NONE; SFS:(13230025)(4636009)(376002)(396003)(136003)(366004)(39860400002)(346002)(451199018)(38100700002)(55016003)(71200400001)(7696005)(83380400001)(33656002)(110136005)(316002)(91956017)(44832011)(8676002)(66946007)(5660300002)(66556008)(66476007)(8936002)(76116006)(64756008)(52536014)(41300700001)(66446008)(478600001)(2906002)(122000001)(82960400001)(6666004)(86362001)(38070700005)(9686003)(53546011)(186003)(6506007)(166002)(966005); DIR:OUT; SFP:1101;
x-ms-exchange-antispam-messagedata-chunkcount: 1
x-ms-exchange-antispam-messagedata-0: Fjw4ltSmysx29iO8RHSTWEfn4EaNoEDhhacubkMN6A4ObFxBIDPgRX3kcowvvwayz6IWhrj09Ev7Opa7jsnigVLWAmCRkGwLGijjImKN9v4pCP90uHdJx1vzNlEnlFCboQIYdbjYOOENanvHpafamD+8CLkHR38zySpg5GICroTFsh9KWAHBOjcBp6XEev9M2t6vkJ1X3sLLizwKJyVKU6AnG5xDZkZJSCphEkNcdhr9wvVJxGC0Od48e7+1Jn9jah5rBNPNTyyCXs+tc4ck0klA3qqbfEti0h/AFgMryR2xc6WzhGgiavyi33YCqo6rKgTWZRFA9hSatsZauVLQ2fRwmIwAN5cj2MRjqwbTE8fNH9HFdncNYBlenuS2gzZEvgqmnq1JrviLA57SC7+VwzLfHW5v6KdcUn2Uo0tbjjJVTivO1N1QO4Xrrqc3aj2UeCmPI1QiO6jSnX10Hm2vVf7NyItsuENnVbdoU8yfGmM2Noy0fhSsw+dz0kyJcY1Q6Mi9N/LDQ8YBZD6pi6AvBMWV8AHJ75TYa8dBncWRI2lAuvOTHHUgdrdFgh82x/1pk4dhoxGTSdWwG1fr6dkxu2DJmT+OrRYhuDHde7jajRDFUbDPSb7JYXn2tnWWeW7lKe7V9be61du95ooCczfp/bdP6RKd86I0Khm3gLv/A++VcqUZwBr6b7q2kgGYuxArIAFIEd7qzij659ULIJ0EIh3LMTf0XGYX1jzHFT/uiqn8GEjBKYS/PCWPc9w90zPQHApLbmfEoi45LHlQ3mRLwCo831uTqxHu4djOPQczuT73HvKLuEbw7hhW53CXkhI7tOQNaTqdI9pNNouPt6IhvcHs4YtlUg3E9Jz9xS4JMHVT/OrlyH5NMXQtv0ifcq3SHxselEQW/lvsi6y9ndkw7eZJE1gTLyf2QT8g+DMTVONamBAQC9h8oq82uSA6uSgqBxQmdksf9GmsCEYh1oFCEOvf2JKjSCWgjnTFTZC9BOxlbg1+SUNcFwETCurg+tku/HOVxX09G2b8T1pBmzgx70aNMTCtNE5vQHWRVcyI+w8UzNxbE7ctQ+5wuuNVZTRixbQ9VxMAGoRvm3zmolKqy0TEuhjCAwIjCEDQELg7jDtbz0jEU4u5aSG8fcfabhYA5nl2LyUOaUP5JEDD62Q1Vl58NWAjeLZxLZtXvZbRG3E4lT5/HEIBCHuuIK3MSLgjZK2BxZ4GC7016tEoINavTXd5fREfND669TLtPZsTTIR7+6vIak8VzOJNnr8kdxd5T7/e9V64oTRyo9EUpcNntztmFo9BBl/Ldw5TEmEgcJsifd/t+qBEuRDUS+TwxTPW22NSoTykwqTZXnGl0iMuFym5UiKCN0zVckR4MGdbLY733NRzcwv56oby4ateoRLgk6OXeqwIm/UtYegvu3zS6ACKvwrDDy84jWmSB8DpxjlBVOZt1caaEtm+XjQFDddyvKZTq8rnk3lTj88uUTlCeS5AJRmPVJ8Nb8yctZIqrT3aOZpFG1SA1bYwi/POB+diTSh5ss3nQv37fz0q7vASAPckNP82xoJiR8yd43VMcz4OkomdIHLa5cYc57PLFzTcis7CJ8DCTu/eZ33hMzwp3hlR1zIG4uPzCWWSfN+2Ap2wSSTBpfuKdqWb/Aj9xdGYgFf3SIU0yDl4jUTUbIV9ybCHIAwrGjYUUInXE+q5IvU=
Content-Type: multipart/alternative; boundary="_000_AS1PR07MB861696AA62E3EA3BCDE1815498819AS1PR07MB8616eurp_"
MIME-Version: 1.0
X-OriginatorOrg: ericsson.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-AuthSource: AS1PR07MB8616.eurprd07.prod.outlook.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 2fe837db-7a54-4dea-8310-08db29f083ef
X-MS-Exchange-CrossTenant-originalarrivaltime: 21 Mar 2023 09:41:58.5146 (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: z6+Fa6+jnkGmalDhL2zQUYaA9/6UXL4H2NJiUhUIrjFBBMLHAn9SSufCTAgcxOzNrApF+QR/cxrhNpSkPaF4ApFnkBsCSbyjRMGBcYvKyesneZzYFfGDOYHZQ9TsLjma
X-MS-Exchange-Transport-CrossTenantHeadersStamped: PA4PR07MB7309
Archived-At: <https://mailarchive.ietf.org/arch/msg/httpapi/RMNNgQOX0GOD35-hGfJ7_xmkZuc>
Subject: Re: [httpapi] AD review of draft-ietf-httpapi-yaml-mediatypes-04
X-BeenThere: httpapi@ietf.org
X-Mailman-Version: 2.1.39
Precedence: list
List-Id: Building Blocks for HTTP APIs <httpapi.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/httpapi>, <mailto:httpapi-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/httpapi/>
List-Post: <mailto:httpapi@ietf.org>
List-Help: <mailto:httpapi-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/httpapi>, <mailto:httpapi-request@ietf.org?subject=subscribe>
X-List-Received-Date: Tue, 21 Mar 2023 09:42:07 -0000
Rich, Darrel, Thanks, good to see this was discussed in the working group (note for next time, do tag me or even better ping me when mentioning me to make sure I see it). As I said, the point has come up in the IESG, but as long as the BCP 14 normative language is not used to define standard track protocols (which is not the case here), I see it as fine to use even in informationals. Note to nitpick: I am not sure how relevant is section 1.2 of RFC 6838 for this discussion, since 6838 is a BCP describing how to do media type registrations, and 1.2 refers to itself, not to other docs. I started IETF Last Call. Thanks, Francesca From: Salz, Rich <rsalz@akamai.com> Date: Monday, 20 March 2023 at 20:03 To: Darrel Miller <darrel@tavis.ca>, Francesca Palombini <francesca.palombini@ericsson.com>, draft-ietf-httpapi-yaml-mediatypes@ietf.org <draft-ietf-httpapi-yaml-mediatypes@ietf.org>, httpapi-chairs@ietf.org <httpapi-chairs@ietf.org>, httpapi@ietf.org <httpapi@ietf.org> Subject: Re: [httpapi] AD review of draft-ietf-httpapi-yaml-mediatypes-04 Agree with Darrel. From: Darrel Miller <darrel@tavis.ca> Date: Monday, March 20, 2023 at 1:56 PM To: Francesca Palombini <francesca.palombini@ericsson.com>, "draft-ietf-httpapi-yaml-mediatypes@ietf.org" <draft-ietf-httpapi-yaml-mediatypes@ietf.org>, "httpapi-chairs@ietf.org" <httpapi-chairs@ietf.org>, "httpapi@ietf.org" <httpapi@ietf.org> Subject: Re: [httpapi] AD review of draft-ietf-httpapi-yaml-mediatypes-04 Francesca, Thank for the review and the comments. The issue of normative language in the media type registration did come up here https://github.com/ietf-wg-httpapi/mediatypes/issues/22<https://urldefense.com/v3/__https:/github.com/ietf-wg-httpapi/mediatypes/issues/22__;!!GjvTz_vk!SFAUf7-T8Am0gRzTX-OuKiRDrdaVxr5B9L9Maepybq3twStz6tKL0SWMl0_u4qGl6wXWXV3JO2Kp$> Based on the fact that RFC 6838 supports the use of BCP 14 keywords in section 1.2 and that Informational documents are allowed for registration in the Standards Tree (section 3.1), I am fully supportive of the use of the GCP 14 language in the document. I agree with points 2 and 3 that some additional words would help with clarity. Having reviewed the Faq again, I don’t believe there is any content there that needs to be in the main document. Darrel From: Francesca Palombini<mailto:francesca.palombini@ericsson.com> Sent: March 20, 2023 12:28 PM To: draft-ietf-httpapi-yaml-mediatypes@ietf.org<mailto:draft-ietf-httpapi-yaml-mediatypes@ietf.org>; httpapi-chairs@ietf.org<mailto:httpapi-chairs@ietf.org>; httpapi@ietf.org<mailto:httpapi@ietf.org> Subject: AD review of draft-ietf-httpapi-yaml-mediatypes-04 Thank you for the work on this document. I have a couple of high-level comments on the document, but nothing major. I would like to have a second confirmation from the chairs on the doc track before starting the IETF LC (see 1. below). Thanks, Francesca 1. ----- I note that the working group as requested publication as informational, which is fine for its purpose of reference document for a media type registration. I also wanted to note that the IESG has time and time again gotten to discuss if BCP 14 terms (and boilerplate) should be allowed in informational documents (normative text in informational docs). There is nothing explicitly forbidding it, and I believe in this case the use of these terms does not conflicts with the doc status, so I am not asking the wg to change anything. I am just bringing it up as I expect it might come up in IESG evaluation and it will be good to have a strong consensus then. 2. ----- Section 2.1: > Deprecated alias names for this type: application/x-yaml, text/yaml, text/x-yaml I would suggest adding some text to clarify these are used but not registered (in accordance with https://www.rfc-editor.org/rfc/rfc6838#section-3.4<https://urldefense.com/v3/__https:/www.rfc-editor.org/rfc/rfc6838*section-3.4__;Iw!!GjvTz_vk!SFAUf7-T8Am0gRzTX-OuKiRDrdaVxr5B9L9Maepybq3twStz6tKL0SWMl0_u4qGl6wXWXU7hM03z$>) 3. ----- Section 3.3: > The simultaneous usage of two filename extensions in the same context might cause interoperability issues (e.g. when both a "config.yaml" and a "config.yml" are present). It feels like the text should end with something like "so only one SHOULD be used.", or anyway give more of a strong recommendation - It just feels like the text is recognizing interoperability issues without providing any response to it. 4. ----- FAQ Section: I am a bit conflicted about this section. I do like that it provides context around some choices. I understand that it is to be removed before publication, but seeing it there makes me wonder: why have the wg (or the authors) felt the need to add this section? Is this adding some clarification/justification that is missing from the document? In that case, why was the content not included in the text that will be published, rather than exiling it at the end?
- [httpapi] AD review of draft-ietf-httpapi-yaml-me… Francesca Palombini
- Re: [httpapi] AD review of draft-ietf-httpapi-yam… Darrel Miller
- Re: [httpapi] AD review of draft-ietf-httpapi-yam… Salz, Rich
- Re: [httpapi] AD review of draft-ietf-httpapi-yam… Francesca Palombini
- Re: [httpapi] AD review of draft-ietf-httpapi-yam… Roberto Polli