Re: [Cbor] [core] WG Last Call on draft-ietf-core-problem-details

Thomas Fossati <Thomas.Fossati@arm.com> Mon, 16 May 2022 12:10 UTC

Return-Path: <Thomas.Fossati@arm.com>
X-Original-To: cbor@ietfa.amsl.com
Delivered-To: cbor@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 7E02EC183538; Mon, 16 May 2022 05:10:14 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.894
X-Spam-Level:
X-Spam-Status: No, score=-1.894 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, HTML_MESSAGE=0.001, RCVD_IN_ZEN_BLOCKED_OPENDNS=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, UNPARSEABLE_RELAY=0.001, URIBL_BLOCKED=0.001, URIBL_DBL_BLOCKED_OPENDNS=0.001, URIBL_ZEN_BLOCKED_OPENDNS=0.001] autolearn=unavailable autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=armh.onmicrosoft.com header.b=7aqZSV+o; dkim=pass (1024-bit key) header.d=armh.onmicrosoft.com header.b=7aqZSV+o
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 ssALjsX2Re0I; Mon, 16 May 2022 05:10:10 -0700 (PDT)
Received: from EUR03-DBA-obe.outbound.protection.outlook.com (mail-dbaeur03on20622.outbound.protection.outlook.com [IPv6:2a01:111:f400:fe1a::622]) (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 EE50CC183539; Mon, 16 May 2022 05:10:09 -0700 (PDT)
ARC-Seal: i=2; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=pass; b=JKx76q7r5r0FrmnlNnz85qVMt2O64FDbbrGTrm4sOi7ebrbLzJ/gYnJ+t3DI4sbxDyM/Bi0GUz+D0MobT4IUpzRVwyUFwsgqkPXR+XkN+1KupXhNsRKSKx2yGl7tLeRJg5XVMzMR3IxnKJNERpfOCIA2mzKlcysKHN0jJzc+dGta6ySqFsptnkfZhOHXg6S34ePrqk3/kRSWsw8KQnf2w++UsEH+6gO82/6nTQdf/bV4AGge2Xb8QXhTGa3SdRdu/tZOvo+/YEUx7nIvWUfDOiZ4np7+ijhrEw2/275BTfqe/F95IZRqb3bSE2spG2qIJeC4+Yc+w/PuFQWzBGzbAA==
ARC-Message-Signature: i=2; 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=O7RpBi9v4o4AhRaCXuKmL4unw0SighT04mtrQyB6H5g=; b=T0iXkhNwcTpEy0aFiGbqcoBuYDv870E0BendRugxZVOzf0L+dLqCHtTENG4XK7j/4TosnU9GtLSPgsPLXs6rIAVIV4ddgh8/nz1jOkB32yPFxIgZTGl2NlFPFWEykMiNQhXEsklHS2XjYlaOcunvK2S3I0TviAGqNlPJsIbFUeM6EfHiXOep5FF7OuOQcaqFNXoL8aeuy+0xzHv6zN6FzJNygVnwz9owqOBeIUiGMcmB+WKdk4w9LlMKaUO2hD92Lhmq1w1pn1+4s4oNhll0iqm+Zy8/l2sppa/BnfF5ue4KSjbl6ZgvVxcsm01kdxHIogDDFBmH7e75BTGbVoDwXg==
ARC-Authentication-Results: i=2; mx.microsoft.com 1; spf=pass (sender ip is 63.35.35.123) smtp.rcpttodomain=ietf.org smtp.mailfrom=arm.com; dmarc=pass (p=none sp=none pct=100) action=none header.from=arm.com; dkim=pass (signature was verified) header.d=armh.onmicrosoft.com; arc=pass (0 oda=1 ltdi=1 spf=[1,1,smtp.mailfrom=arm.com] dkim=[1,1,header.d=arm.com] dmarc=[1,1,header.from=arm.com])
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=armh.onmicrosoft.com; s=selector2-armh-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=O7RpBi9v4o4AhRaCXuKmL4unw0SighT04mtrQyB6H5g=; b=7aqZSV+ocnNtnQ9gOy8Hi/8ATlb9h42bUSpykFhIQwHHRUvXjyypY4n9gJDsd+X3OSLlz2QHQlvKtVEXbZxoEZa/OaHJBV4FMKbhKVWIOJClhSQN/5X6H2jzIaH5S2nUcnNSO5+B8oPfX4VMIu5pp8zMpIG5P7PCrNUT0x2S3sM=
Received: from AS8PR07CA0039.eurprd07.prod.outlook.com (2603:10a6:20b:459::8) by HE1PR0802MB2569.eurprd08.prod.outlook.com (2603:10a6:3:e1::22) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5250.15; Mon, 16 May 2022 12:10:04 +0000
Received: from AM5EUR03FT061.eop-EUR03.prod.protection.outlook.com (2603:10a6:20b:459:cafe::f9) by AS8PR07CA0039.outlook.office365.com (2603:10a6:20b:459::8) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5273.13 via Frontend Transport; Mon, 16 May 2022 12:10:03 +0000
X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 63.35.35.123) smtp.mailfrom=arm.com; dkim=pass (signature was verified) header.d=armh.onmicrosoft.com;dmarc=pass action=none header.from=arm.com;
Received-SPF: Pass (protection.outlook.com: domain of arm.com designates 63.35.35.123 as permitted sender) receiver=protection.outlook.com; client-ip=63.35.35.123; helo=64aa7808-outbound-1.mta.getcheckrecipient.com;
Received: from 64aa7808-outbound-1.mta.getcheckrecipient.com (63.35.35.123) by AM5EUR03FT061.mail.protection.outlook.com (10.152.16.247) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5250.13 via Frontend Transport; Mon, 16 May 2022 12:10:01 +0000
Received: ("Tessian outbound 32b886dfa5b9:v119"); Mon, 16 May 2022 12:10:01 +0000
X-CheckRecipientChecked: true
X-CR-MTA-CID: c10e4bd9abc22f18
X-CR-MTA-TID: 64aa7808
Received: from 3d8ea606c33a.1 by 64aa7808-outbound-1.mta.getcheckrecipient.com id 467F110F-F85E-4A36-8F89-9AC6D9ED759B.1; Mon, 16 May 2022 12:09:54 +0000
Received: from EUR02-VE1-obe.outbound.protection.outlook.com by 64aa7808-outbound-1.mta.getcheckrecipient.com with ESMTPS id 3d8ea606c33a.1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384); Mon, 16 May 2022 12:09:54 +0000
ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=lkZacpplrg7k1BW8wgj5GIs6R0+8l52baoejpBkDaQbV2PgNiB8Kky1g7ZdopAPKHNHq6WrivD1Ft287vNRPNVWSsEuzdEuSlud01GbrRLaP6CTxq0+RjxkDaOaFe3DEsStsDI0q98kcUgyXrvaCjzWMu/FkBD93hMRrm9/cLHhEPn2B3HdTJEGnTG706MyenqeebduZd8DgO244D7/y58F6dPBV8RkMM9je2fLs66YdKrYSOQ1E7GxC4zP+8ReWq0bPr+tFpnXNYVFxoHN/XvkNTmAEzMWkZ0PBBRDgX3+fdj4goZGgZLBWxzpCJ70pM0/oopI73Rwp8DVNpxykBQ==
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=O7RpBi9v4o4AhRaCXuKmL4unw0SighT04mtrQyB6H5g=; b=cA2j4KBvTuyyaCvnQVUYcpOmqagHbYnZaMxA6+FAUTgZMLBYhjF3777uZpaftngVw7jQl3gH7ZgO6jG6lSIMGRIBdNYFcRNBdITO4IQez8EDj0fNsA6RX/+CXoAPUqmCf+OOav0/NmXytGdLedaLNYNk18DEsAw+i64E/C7kufle5RPv4B6KUtgkuHTSfDpXZIrax9FEqZ+PsNCZO3fXpDs/wDI26GjZW86ooR9d19WF667WueNpXu4ZV3dYm/fg7KcghRwYKfWZkNozXTCaGH4sN1NFLpzXOvrvmlZhtpM9Ozh/0dLLAbHld+DoM2P+O3zU+v+AtNmpUYxQ0pXgHQ==
ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=arm.com; dmarc=pass action=none header.from=arm.com; dkim=pass header.d=arm.com; arc=none
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=armh.onmicrosoft.com; s=selector2-armh-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=O7RpBi9v4o4AhRaCXuKmL4unw0SighT04mtrQyB6H5g=; b=7aqZSV+ocnNtnQ9gOy8Hi/8ATlb9h42bUSpykFhIQwHHRUvXjyypY4n9gJDsd+X3OSLlz2QHQlvKtVEXbZxoEZa/OaHJBV4FMKbhKVWIOJClhSQN/5X6H2jzIaH5S2nUcnNSO5+B8oPfX4VMIu5pp8zMpIG5P7PCrNUT0x2S3sM=
Received: from DB9PR08MB6524.eurprd08.prod.outlook.com (2603:10a6:10:251::8) by DB8PR08MB4971.eurprd08.prod.outlook.com (2603:10a6:10:ed::17) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5250.13; Mon, 16 May 2022 12:09:52 +0000
Received: from DB9PR08MB6524.eurprd08.prod.outlook.com ([fe80::adc5:f2d3:1920:7e3c]) by DB9PR08MB6524.eurprd08.prod.outlook.com ([fe80::adc5:f2d3:1920:7e3c%7]) with mapi id 15.20.5250.018; Mon, 16 May 2022 12:09:52 +0000
From: Thomas Fossati <Thomas.Fossati@arm.com>
To: Marco Tiloca <marco.tiloca=40ri.se@dmarc.ietf.org>, "core@ietf.org WG (core@ietf.org)" <core@ietf.org>
CC: "cbor@ietf.org" <cbor@ietf.org>, "httpapi@ietf.org" <httpapi@ietf.org>
Thread-Topic: [core] WG Last Call on draft-ietf-core-problem-details
Thread-Index: AQHYZVAdI97xM/4rz0CT0IcaQu8+IK0hJ7AAgABJChg=
Date: Mon, 16 May 2022 12:09:52 +0000
Message-ID: <DB9PR08MB6524744BFCCA48BE838E9FD39CCF9@DB9PR08MB6524.eurprd08.prod.outlook.com>
References: <3a2fb1c8-5c50-fa7a-0672-a73c3b6f1a5f@ri.se> <30688e38-7936-b76a-911c-3a398f2c4de3@ri.se>
In-Reply-To: <30688e38-7936-b76a-911c-3a398f2c4de3@ri.se>
Accept-Language: en-GB, en-US
Content-Language: en-GB
X-MS-Has-Attach:
X-MS-TNEF-Correlator:
Authentication-Results-Original: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=arm.com;
X-MS-Office365-Filtering-Correlation-Id: c686e532-5337-483e-80c7-08da37350125
x-ms-traffictypediagnostic: DB8PR08MB4971:EE_|AM5EUR03FT061:EE_|HE1PR0802MB2569:EE_
X-Microsoft-Antispam-PRVS: <HE1PR0802MB2569225F0CFAA1439157F59F9CCF9@HE1PR0802MB2569.eurprd08.prod.outlook.com>
x-checkrecipientrouted: true
nodisclaimer: true
X-MS-Exchange-SenderADCheck: 1
X-MS-Exchange-AntiSpam-Relay: 0
X-Microsoft-Antispam-Untrusted: BCL:0;
X-Microsoft-Antispam-Message-Info-Original: yeFVsEubaLGrSRmGhTO3eoQH1e1U6m++ga0/kJJmXvdo4yslO96TzQqoHl4AqkQa2kTUN7yVEYsIbO7L5XPAk4+ozGo6mtHkTR2PLPtqRuY5c2vm1kJMtHWEwppiJ4O+9g5w8/hISVXlAsTNxeVXZQuHD9jTvk5D+GPG+7/MW5h1ksymhqTcm4cUJpeJlRPe8u//Q51xsOappugT6sMYRMnNNU3vjTdwGPO/APhEKks7JE+/XAiaIUVVvH9sz9TTqToAi3XT3j/UE8CQwftXDExzrR5iERGpqbpymqvZDFKuEs+BNptDBTWCC0jS3Xg980YzF0TMCRJRTEz2zj/coavet/Nv6uf5HbjPGh9s18EaudNJzLOgeYk59oZ9FaEhcERSnai4dTbykMMSl8VTROKrmLMU/tTNfBlie+m20SQCMs9H3NwuPGgxSeZNE4Ad2UrctzLocchfjQfa/Bptexn3QKbCtILd0XLCubdhAz3SVUnWb1oInp4DB/qJnBIXsVlNKjlopo5P+BKOzUGa4Ns0Wekkn+3tQd3NdKjpkMbwGf7H12sVPCwQd48wfYbxtBAuqXygD7FyommXo1WMbYqjyRa1eJa02J5XLHh4mU32VJ8f7p7iRATO1mvxQjOAIsFhEPTnuYS+az3WI0n4cx6cpaUuYeaVfrI7raEJ9ESHFTLcT3bGm0cvZS8u6OW6lm82mqCV5gS4LmdkkhPxRfYtrfyuU9jBwreqwcRbfwFxWSUNKWwHMHzoaHcpnNUAxaQ6bJzNY/aqScLGhzoq6NhShbbTZ7FTaT4Sxb7nTVReyiAu7nos3rme5ibaoKOHPZRPtJlRr3AseLrLk4Ovyw==
X-Forefront-Antispam-Report-Untrusted: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:DB9PR08MB6524.eurprd08.prod.outlook.com; PTR:; CAT:NONE; SFS:(13230001)(4636009)(366004)(66574015)(86362001)(186003)(52536014)(83380400001)(7696005)(508600001)(8936002)(316002)(38100700002)(38070700005)(5660300002)(966005)(26005)(6506007)(54906003)(66946007)(66476007)(66446008)(64756008)(66556008)(76116006)(53546011)(55016003)(33656002)(91956017)(8676002)(2906002)(122000001)(110136005)(71200400001)(4326008)(166002)(9686003); DIR:OUT; SFP:1101;
Content-Type: multipart/alternative; boundary="_000_DB9PR08MB6524744BFCCA48BE838E9FD39CCF9DB9PR08MB6524eurp_"
MIME-Version: 1.0
X-MS-Exchange-Transport-CrossTenantHeadersStamped: DB8PR08MB4971
Original-Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=arm.com;
X-EOPAttributedMessage: 0
X-MS-Exchange-Transport-CrossTenantHeadersStripped: AM5EUR03FT061.eop-EUR03.prod.protection.outlook.com
X-MS-PublicTrafficType: Email
X-MS-Office365-Filtering-Correlation-Id-Prvs: 912268fd-658d-45ad-ad37-08da3734fb7d
X-Microsoft-Antispam: BCL:0;
X-Microsoft-Antispam-Message-Info: R2RnBIML0q5TaFlYWT4YpwyyWsrTCyObZ3rslmaflorwWZKeXuSWarHmpdziTp/NgEh3jhOJd33CQS2jmyrTDY0eF+RJVqcfeTnaELe9VXhoVjZmecMFCewE9SafUl+tEzPcgXgDyBB61MmO6MoIBpscVOZu4t6Qn9CPB9Efc1b4/JxHjyl24SxLgEfNsHSZkUj/ELNm3YRgaHjyqV5JZUj33X3fwE27zjy3n/HY630DJ3Kn7dzGY3bLLZgC7UEzptQPQO/hKuo0p2mPZykQKMxHugmQ7X2blEEW9SM2+NlijOy2ZZjXorY3hMrx1veBWxF7UJqpnfJhoMjklmeR1Ufk9LwRn1hzYW+nNxopSWyVYnjb8DjVc6eUW3Ko5aXW9o6/tMfaTK4bcIRtANasZgrIG8+wgzbHIHEgQ4C66+EADm3jbDMKpOLhFa27umljS0sQ4Ce9BtC2FbJ3mYRw1jF3Flb/meZrH3MLK++GzhG8M+qT4YYeNYMEUmSvVlcIpnHHQs3AuNjKlcGIx2FNbHGsZCLKsDuLNCM+hUSty3RfzAyznLfC3a4p0Znuv41gLfd6T8tiMhqG/R/56HBPtZRk9a65OiCR8bGct6ocjdmRg/0fhW4iQdjhojAauEyV3J53zR5pJJW19h/FGZMPkz8Z8BHnvVtuSJgBHLrRk5xrhB2RE1SVot++pyWB4JTn1VlwzBkmTtvjMmSM+aXFOeG8AOrfSID7Qs+TRWPIcBKg43F+TS15GRv3c7xKlGlpSgio2eheyLIR6tvmd5+LBn8tVYL4jlOrzmypR4518Es=
X-Forefront-Antispam-Report: CIP:63.35.35.123; CTRY:IE; LANG:en; SCL:1; SRV:; IPV:CAL; SFV:NSPM; H:64aa7808-outbound-1.mta.getcheckrecipient.com; PTR:ec2-63-35-35-123.eu-west-1.compute.amazonaws.com; CAT:NONE; SFS:(13230001)(4636009)(46966006)(36840700001)(40470700004)(508600001)(966005)(40460700003)(53546011)(6506007)(110136005)(83380400001)(36860700001)(54906003)(26005)(9686003)(8936002)(86362001)(356005)(316002)(7696005)(66574015)(47076005)(166002)(82310400005)(55016003)(81166007)(8676002)(4326008)(70206006)(70586007)(52536014)(5660300002)(2906002)(33656002)(336012)(450100002)(186003); DIR:OUT; SFP:1101;
X-OriginatorOrg: arm.com
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 16 May 2022 12:10:01.7282 (UTC)
X-MS-Exchange-CrossTenant-Network-Message-Id: c686e532-5337-483e-80c7-08da37350125
X-MS-Exchange-CrossTenant-Id: f34e5979-57d9-4aaa-ad4d-b122a662184d
X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=f34e5979-57d9-4aaa-ad4d-b122a662184d; Ip=[63.35.35.123]; Helo=[64aa7808-outbound-1.mta.getcheckrecipient.com]
X-MS-Exchange-CrossTenant-AuthSource: AM5EUR03FT061.eop-EUR03.prod.protection.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Anonymous
X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem
X-MS-Exchange-Transport-CrossTenantHeadersStamped: HE1PR0802MB2569
Archived-At: <https://mailarchive.ietf.org/arch/msg/cbor/47MwgOzBPB37p2A82Vl3sCs_Y54>
Subject: Re: [Cbor] [core] WG Last Call on draft-ietf-core-problem-details
X-BeenThere: cbor@ietf.org
X-Mailman-Version: 2.1.34
Precedence: list
List-Id: "Concise Binary Object Representation \(CBOR\)" <cbor.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/cbor>, <mailto:cbor-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/cbor/>
List-Post: <mailto:cbor@ietf.org>
List-Help: <mailto:cbor-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/cbor>, <mailto:cbor-request@ietf.org?subject=subscribe>
X-List-Received-Date: Mon, 16 May 2022 12:10:14 -0000

Awesome, thanks a lot Marco!

Tracked here: https://github.com/core-wg/core-problem-details/issues/17

Cheers, t

From: core <core-bounces@ietf.org> on behalf of Marco Tiloca <marco.tiloca=40ri.se@dmarc.ietf.org>
Date: Monday, 16 May 2022 at 08:47
To: Marco Tiloca <marco.tiloca=40ri.se@dmarc.ietf.org>, core@ietf.org WG (core@ietf.org) <core@ietf.org>
Cc: cbor@ietf.org <cbor@ietf.org>, httpapi@ietf.org <httpapi@ietf.org>
Subject: Re: [core] WG Last Call on draft-ietf-core-problem-details
Hi all,

Please find below my review comments.

Best,
/Marco



[Section 1.1]

* Please add the usual remark "Readers are expected to be familiar with ..."


[Section 2]

* The caption of Figure 2 can better say "Concise Problem Details Data
Item".

* The definition of the 'title' entry says: "It SHOULD NOT change from
occurrence to occurrence of the problem."

    Do you mean "of the same problem" ?

* The definition of 'response-code' can be expanded to also point to
Section 3 of RFC 7252, and explicitly say that the response code here is
exactly the value of the 'Code' field in the header of the CoAP
response. This would complement the statement and example in the last
paragraph of the section.

* When defining the entry 'response-code', it is good to have a pointer
also to Section 3.2 of RFC 8132, thus covering also 4.09 and 4.22.

* "Note that, unlike [RFC7807], Concise Problem Details data items have
no explicit type."

Consistently, please consider the following changes to avoid possible
confusion:

    - In Section 1, use "problem classes" rather than "problem types".

    - In Section 2, use "summary of the problem class" rather than
"summary of the problem type" when defining the 'title' entry. A few
paragraphs below, "shorthand for the category of the error" can also
become "shorthand for the class of the error".

    - In Section 3, use "generic problem class container" rather than
"generic problem type container".

    - In Section 5.1, as to the "Brief description" for 'title' in Table
1, use "problem class" rather than "problem type".


[Section 3.1]

* "Consumers of a Concise Problem Details instance MUST ignore ..."

    I think it is better to use "data item" rather than "instance". That
would be consistent with the text in other sections and would avoid
confusion with the 'instance' entry.


[Section 3.2]

* "Consumers of a Concise Problem Details instance MUST ignore ..."

    See the comment above about using "data item" rather than "instance".

* Is it admitted to change the definition of an already existing Custom
Problem Details entry, by updating the related documentation? Or is it
something to discourage or even forbid, rather preferring a new entry to
be defined altogether?


[Section 5.1]

* For 'title' and 'detail', shouldn't the CDDL Type be "text/array",
rather than "text"? If tag 38 is used, that applies to an array, as per
Appendix A.2.


[Nits]

* Section 3.1, s/so they never can/so they can never

* Section 3.2, s/the nested map any/the nested map, any

* Section 3.2, s/for extension that/for extensions that

* Section 3.2, s/compact representation, in/compact representation. In

* Section 3.2, s/principle, MUST NOT be/principle, it MUST NOT be

* Section 5.1, s/Entries in Standard/Entries in the Standard

* Section 5.2, s/Entries in Custom/Entries in the Custom

* Table 1/2/3, s/RFCXXXX/RFC XXXX

* Appendix B (2 instances), s/Concise Problem Details item/Concise
Problem Details data item

* Appendix B (2 instances), s/Custom Problem Detail entry/Custom Problem
Details entry


On 2022-05-11 17:59, Marco Tiloca wrote:
> Dear all,
>
> This mail starts a Working Group Last Call for the document:
>
> https://datatracker.ietf.org/doc/html/draft-ietf-core-problem-details-03
>
> Please provide your comments and feedback by Tuesday, the 24th of May.
> This will allow us to discuss the results at the CoRE interim meeting
> on the day after.
>
> (This call also includes the CBOR and HTTPAPI Working Groups in CC)
>
> Best,
> Marco (for the CoRE Chairs)
>
>
> _______________________________________________
> core mailing list
> core@ietf.org
> https://www.ietf.org/mailman/listinfo/core

--
Marco Tiloca
Ph.D., Senior Researcher

Division: Digital Systems
Department: Computer Science
Unit: Cybersecurity

RISE Research Institutes of Sweden
https://www.ri.se

Phone: +46 (0)70 60 46 501
Isafjordsgatan 22 / Kistagången 16
SE-164 40 Kista (Sweden)
IMPORTANT NOTICE: The contents of this email and any attachments are confidential and may also be privileged. If you are not the intended recipient, please notify the sender immediately and do not disclose the contents to any other person, use it for any purpose, or store or copy the information in any medium. Thank you.