[httpapi] AD review of draft-ietf-httpapi-yaml-mediatypes-04

Francesca Palombini <francesca.palombini@ericsson.com> Mon, 20 March 2023 16:28 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 D5ECBC16B5B4; Mon, 20 Mar 2023 09:28:36 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.097
X-Spam-Level:
X-Spam-Status: No, score=-2.097 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, 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 ZCjeHgqmraEM; Mon, 20 Mar 2023 09:28:32 -0700 (PDT)
Received: from EUR05-AM6-obe.outbound.protection.outlook.com (mail-am6eur05on20628.outbound.protection.outlook.com [IPv6:2a01:111:f400:7e1b::628]) (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 1553CC137399; Mon, 20 Mar 2023 09:28:31 -0700 (PDT)
ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=aeduKzGvSA9WVzI05FcEQBw40VEfzVjtNS4XVkP0ceX8+ZNMRfnetLuRlofjztGPatQtQx5sHfzJCFgP/55TZ+1z/rU2+IzC8YPfLZscpUoTatu/pLOo8hF3zstOvKzRBL0PRwMcvJoH+vsbPytnrrTSPyl45mbX7pkBlmKlDXrUz3Jkm/4g7CxikZWhb2I968ZYr+9oR4F/9tm22bM+u8hOKEFC1kKbhJVWG6iZeTZsDsyW7TCoDn5eTxp2TdTwJMJWAgxwAsQQgI429/pFT4uK97y2M0VitQu8ySQ+OishMP+FgK1+VGdUv7WIFrVg/9KOA5IFvJF8JObVTSAuEQ==
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=+K2En+1/bxriDPRlIvDYHwrnaESyczZ4TEaL6/cai/g=; b=ZqvUtTcDqLi18zda98Gon+xbFwV++cIqjSkRoud2+kGQxYXvD9FBF92DnU+wBJCNLtRdYM2Hopm5R4fNV5ido0PkxSPN2QybT03cALa+A/V7nASEEvz9o5lhTa4/Zfm4WA/bG9tYsTefN8ez9zGyosCduBrlJyjXsp/bdBwVtaure1tOol205eCSXUnXY3MFCi5i/Jw4advQuxOpgL9NKvV/+uhdZVnB+cykEZwKdV9ZVfzLFyYG/aqAKxziUNHyv1bqinSGwdKldo482YvDkMzValxTWhRQqcrBaeQ+5TzbNpMYE6mTc35wWSDtB2dDFgP5tmRzn4zNyZjOOKCrKQ==
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=+K2En+1/bxriDPRlIvDYHwrnaESyczZ4TEaL6/cai/g=; b=ZQimKxoXCZgsXPMP3RQT7b88ZpGlUZS96WhLXyI+tgCN4cXWP/isSz5fs93pj2uIDBHj6oGExgUO5bca+x3yI2Q5uwYmmJKVtTarTrjkR6Owk1AJHiYu4tDTHlFxVSBSRRloT7Mfsiq4LsWWLHD6cEjCeelDDebLKE4Y4cTEtlM=
Received: from AS1PR07MB8616.eurprd07.prod.outlook.com (2603:10a6:20b:474::16) by DU2PR07MB8288.eurprd07.prod.outlook.com (2603:10a6:10:27a::13) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6178.37; Mon, 20 Mar 2023 16:28:27 +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; Mon, 20 Mar 2023 16:28:23 +0000
From: Francesca Palombini <francesca.palombini@ericsson.com>
To: "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: AD review of draft-ietf-httpapi-yaml-mediatypes-04
Thread-Index: AQHZW0d51ziUccomkEqbK34ROHGINw==
Date: Mon, 20 Mar 2023 16:27:52 +0000
Message-ID: <AS1PR07MB86163E66C1C4AFF1B66E7FCC98809@AS1PR07MB8616.eurprd07.prod.outlook.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_|DU2PR07MB8288:EE_
x-ms-office365-filtering-correlation-id: 08bd9243-51d9-4de0-c8f2-08db29602018
x-ms-exchange-senderadcheck: 1
x-ms-exchange-antispam-relay: 0
x-microsoft-antispam: BCL:0;
x-microsoft-antispam-message-info: VH2k7L3vR4XqpZsqQS1hAeAG7bpdBOHhxoD+sLgTC/dquahEY1wTKlaUYCZHjkOlZBYYWSUWAQycw95POoP0Ok1eq0p5SqDlWxelTo7ABmP5nmRsoSJ97jy2NKWa3KjImZIxzp10YDCihSh9toG7Gjz7TpbLlDQAOOYbQTBq6zCTyDPGfisCqvW88fIe0R2C7ABYMBIjwXgaUw/nzTXyIGzBSGA+6a9oUN6kK8EqvrdWESVSLk6SGOoJQXMg5yCKcDjFAVc0Emoz9QFpAeyOHklPFOkGSJG5XBULGff9UIGoVffOE3mYyPSeRTmkQIsYDYzlGdK8cheAL/c1IM6csl/jdv43J1g0sOONXug2oBq+qFX9qRn2/ty/OhIiJMwT4IAoS0HAA3G78bxq1F1CKpP+2SdxJWu9IYlIzFZh9s0iFasfUupq9g2mbsl2HrMIfQ99g6wDj+Tz4ERRBLJaPH/83U1UpUQKK5p2egUvyuGBcSFxd/aNb9y/7QJMv1f0LGU0/FI6dBV2u7QDq7NrVfZn2Syl4uJIc/3Hny7ctGO0q0OyQPy96vq1CYSXHDKuEs4RijeUkuL2tQwgWAqEfB4/Tx9eG1EHqjWQDTljYIv9WhYX7oaBZJJGKYH88WFBi/G74SkoQF961YNbQqg+teQjCVfWm9FxyC6dft+mCFsvhTS4pZI+bUTMrFQZh+dU
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)(136003)(346002)(376002)(396003)(39860400002)(366004)(451199018)(186003)(6506007)(9686003)(71200400001)(7696005)(966005)(83380400001)(478600001)(316002)(110136005)(6666004)(66946007)(8676002)(66556008)(64756008)(66476007)(76116006)(66446008)(450100002)(91956017)(41300700001)(52536014)(82960400001)(38070700005)(5660300002)(44832011)(166002)(2906002)(38100700002)(8936002)(33656002)(86362001)(55016003)(122000001); DIR:OUT; SFP:1101;
x-ms-exchange-antispam-messagedata-chunkcount: 1
x-ms-exchange-antispam-messagedata-0: syMQn8PEylEeoyUpMRttrhLwXuSE941AepGx6ceP+UNwoh7fbMPde4YpsrGhSvzjS2T7CaWFgQRWI1RdeMgcI4UaH1oDUpjrqLgd2HCzkMcjIZlo4krrHf/61+o23bcZRtx+MIzCeb0c0kFZS9ZoKsXqcGQZ/3F9MCCmFzX5qiihzW+SL/oARtTCO/Fq1BgNMe84S2J1cQGpjYFaJdU17ds33MbxGpi7FxjUB1eRam/p8tfo8F2aSZiB96xbV9pe1qqtBvbv6SrrvTyUUYt1dI53XzKTqVvml4KfkDpd5CljYbNSRvPNxCinO2VPWbhVEHG4dvZz9QklpoZIkJ9Rs87HrV+Nar4w9pTmEbo/aV/NkaLOIEKKKVKJdP7EbaqN6dx1gqjiNTxxUrjy3GGOtfJjEOUAtm57AsaA0/SsjvnfnIuCd+UzCLE93Q1wf+0led0yXx+xWhmMZg9yoOFMltATloD1SOST1hSxjE+E8c7UyrKQexVRPV7IGo9D1R3E3OBwriAKLCwm3oAj7jtVL5l3CuM3myUJkQdHh6oRH4C1cUL/gmVAn2rntjxJCcUlNnOpNUhPlr1XZ5TK9iihh2W1Z8cWQY0naMRBHIjG7fckD1Y47/Zpm/FGdAmo9TNHR9lYwWZLunAg98uDt1I7T9AiuG3Hnz2PlVLsTFBbBOsL6ExSAYubPLcUBuF5tnuTYPn1sPN+7DFUIIvVT7+ANMOMYQO9+sYDkPsrjCMedh+U4M/rge1jlzQwiqKzK4hp4djGy3TdjlrMZ1+RfqgDq9d8UDa2Yydv/LCXEiRuE3Rr2lqCWbwcZ27xo8gZ6Kf2vZOXARSgLyJEp/KDJmkztYJH0xuNfEPEOWKyiitGZ9qj2vFVryM9Iav7LEWIrKCIMEKrF4Q8x0Zi9n08ivREs9vvw8D+VrsRZ3odv0il9A+KZUpotQ5WGtoA70EqlQsFIevYSlF91agiWg7UTQ8gmy0Hft4R0piGA12Aa3AKRvGKvXHiK24E/hAnjlYbAZu2c3e9hJiEps/Vofe9Y0WhT4WhXTB115vwxdPEVmiNPf4VwIsL1bO9Cbj0cyadNsnBb1O3DC5aciG1QpCoQJcWr1dZ2HAkzXkEd3LIGwy13T1MbzTh6j775CSAMkCvx2wfLh8t0oFsnBVm30FF30JOcoovqTXOBUuxUSuZ0xPFb5zIeeRUS0BysanNI5hhuflNJpSpJP4+TnidKuycbIX7k8I+0bGhoMmmIJ+I83AXxPOLjNJIXtDOgksn0JtQBLf8zu4XlTJbJ/rYjuu7LiUnrIwassPHzW6JK0Tmtp6Zk2uaDuCtfFWspf+K1VyLXVoled2EJxEdR0wdrJmPFbxo86FdomNyqyWo0AftASy59kxMMPJmjR+O7eCZ1Wqcp7t+TY80V1meYZfEuZS2MHq/3lzaovdmzW3TqvqhChN7T0EFoWBPuKBe003u5uPUm5bPusTWpYjmopKUXdkqnMhT/+SK0xVJtFYF/uUgVYjv0Ve1oQ7gNQ2aiCDoVxEpENxfzTLQziLokN1PJKxtUEKf5RAftJW8/N7COlkjA58RzZpooOZRx7JATPHpqtdIaneSc50mmhG6Z/ChIbeew5NbD0ATXipGR5hC/KMjfwnWwMs3oU42uo7TAYx92xfmKhKgFlFHTTuevW1tD1lcg+TLeF3air+eDZn+naeRJ6DhTGU=
Content-Type: multipart/alternative; boundary="_000_AS1PR07MB86163E66C1C4AFF1B66E7FCC98809AS1PR07MB8616eurp_"
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: 08bd9243-51d9-4de0-c8f2-08db29602018
X-MS-Exchange-CrossTenant-originalarrivaltime: 20 Mar 2023 16:28:23.4670 (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: qOZD5xxfj2iblngnO0X4fZFcUcBJ9OEHESQF23weJL0PXg19FL+WVOLkVBm3VmEK/4zYxGKXTUZ+06jxdBSc9flxZf5A+hzwZt7bIsH9FLQI6d85COE4xJTE+FWYLlvz
X-MS-Exchange-Transport-CrossTenantHeadersStamped: DU2PR07MB8288
Archived-At: <https://mailarchive.ietf.org/arch/msg/httpapi/v7N1lbzYszVimJOnDR5su6Q_iiw>
Subject: [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: Mon, 20 Mar 2023 16:28:37 -0000

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)

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?