Re: [core] WG Last Call on draft-ietf-core-problem-details
Marco Tiloca <marco.tiloca@ri.se> Mon, 16 May 2022 07:47 UTC
Return-Path: <marco.tiloca@ri.se>
X-Original-To: core@ietfa.amsl.com
Delivered-To: core@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 33935C14F72B; Mon, 16 May 2022 00:47:27 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -3.956
X-Spam-Level:
X-Spam-Status: No, score=-3.956 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, NICE_REPLY_A=-1.857, 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=ri.se
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 v3k5UX3Y00OR; Mon, 16 May 2022 00:47:23 -0700 (PDT)
Received: from emea01-obe.outbound.protection.outlook.com (mail-swedencentralazlp170120004.outbound.protection.outlook.com [IPv6:2a01:111:f403:c202::4]) (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 DB406C14F692; Mon, 16 May 2022 00:47:21 -0700 (PDT)
ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=H0eNonMK6tZ65zoasacmJqayQS2pFGTFDaGDbDCgEENb9Ag7B3pg+K5TOnqGF7+WWVU9blkhDo5EeubN0RrNVBunBBmgnYpQob5BMgMTfnWoeHDCzS7yqeSHyZ/lsh8FJrTokRS/rOea4z0fScQ9ME+DAqkO25d/+UbGF/4yMIccXu4gzx5WpXmzjrVgZ+4cLLw5zjhiDGc1LZ4FE72i8QT0bX0p+yryNQ8SEBBh8kzUlVJCl73UvVZKNC+sNGNC2rl1sa/bESMsUaxOz5WDqle8WM3P8FS7NtEbDHUCgphdnuYSV6eRtUbLV4/ggbxTnce6rlCjvJ2LloYPbcURsg==
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=sdFd1xLsRVTZYILPH508c9df7B1vkO+svytoUFycLYM=; b=EBbatZ+fy9pfQqZ2oAFUVucxXu3xzsxmwhVzi53OmMAK2ow2WdSGS1rdnVU8RvBMGbrEnINJkguKfo7JyH4Xl2G0ZPP+noBya82d773jFNDT/M2ka/SxgSraQt8JJ4orW4ooHsEXTJBqFpCh0rQQh1wlm/DdWrzGN8Ju6P8wBFSRlXDJKK2T7xafwEeSijYNoiavB0K23qznTJfUEIWWTWfY7mc4cVC9Z/x1mrj6DZNYuwG2gTJ1WmyhiwZC7xhlP0aDSI1Zb5sxRIFqcHhejB1R8XKdwP9qBL93hjHumHIgtSS8OBHYMLpTo6Z8eA9HPZ+qTx4J0Xu6Z74BPX+sHw==
ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=ri.se; dmarc=pass action=none header.from=ri.se; dkim=pass header.d=ri.se; arc=none
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ri.se; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=sdFd1xLsRVTZYILPH508c9df7B1vkO+svytoUFycLYM=; b=UTKgSM3alw7aLftutugsgn7jt3fileZm8sZ4iTDj7JfJRy5r0WbxZzBkJDMJBhlJT08EWqiXMCnlsTUKv4DtSYp7hierGDVvRzL7OJbaAkQU0oIgFv0pZMC32CmQrTfPcuqOZGYRlOCFFB4b+NwOMP4xiE+9RcbnXnTWmdoitdI=
Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=ri.se;
Received: from GVYP280MB0464.SWEP280.PROD.OUTLOOK.COM (2603:10a6:150:37::17) by GVYP280MB0208.SWEP280.PROD.OUTLOOK.COM (2603:10a6:150:1a::7) 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 07:47:16 +0000
Received: from GVYP280MB0464.SWEP280.PROD.OUTLOOK.COM ([fe80::582d:af6:c32:fdaf]) by GVYP280MB0464.SWEP280.PROD.OUTLOOK.COM ([fe80::582d:af6:c32:fdaf%6]) with mapi id 15.20.5250.018; Mon, 16 May 2022 07:47:16 +0000
Message-ID: <30688e38-7936-b76a-911c-3a398f2c4de3@ri.se>
Date: Mon, 16 May 2022 09:47:14 +0200
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:91.0) Gecko/20100101 Thunderbird/91.5.0
Content-Language: en-US
To: Marco Tiloca <marco.tiloca=40ri.se@dmarc.ietf.org>, "core@ietf.org WG (core@ietf.org)" <core@ietf.org>
Cc: cbor@ietf.org, httpapi@ietf.org
References: <3a2fb1c8-5c50-fa7a-0672-a73c3b6f1a5f@ri.se>
From: Marco Tiloca <marco.tiloca@ri.se>
In-Reply-To: <3a2fb1c8-5c50-fa7a-0672-a73c3b6f1a5f@ri.se>
Content-Type: multipart/signed; micalg="pgp-sha256"; protocol="application/pgp-signature"; boundary="------------7r0p1glFlGcQJtFRAkK0EaJ3"
X-ClientProxiedBy: AS9PR06CA0298.eurprd06.prod.outlook.com (2603:10a6:20b:45a::6) To GVYP280MB0464.SWEP280.PROD.OUTLOOK.COM (2603:10a6:150:37::17)
MIME-Version: 1.0
X-MS-PublicTrafficType: Email
X-MS-Office365-Filtering-Correlation-Id: 644cc69e-da8c-482e-ed95-08da37104c38
X-MS-TrafficTypeDiagnostic: GVYP280MB0208:EE_
X-Microsoft-Antispam-PRVS: <GVYP280MB02086381F0703244B9DBFF9499CF9@GVYP280MB0208.SWEP280.PROD.OUTLOOK.COM>
X-MS-Exchange-SenderADCheck: 1
X-MS-Exchange-AntiSpam-Relay: 0
X-Microsoft-Antispam: BCL:0;
X-Microsoft-Antispam-Message-Info: H7gjerGY3D8cfIAGXSTOu+KwBkT4Hq7TEn58zXlDrSe8SI/YwhFn9Sqtl4ymSriaCEeQi96XhbqghymcAO4EMYQnHwmTiMKBzsVq0DZj0F42eNh7wLJbU7pj0jCpt8c2SwHduy/LWIzEfYTNw4x4b9LmX3n6gkKD1KJM9cLKYpuF4y3m4WIsaaVxZwaW7gvP2prcHAp/HoKGAifGHVc6tH9PPKYszAypgCX2EVTHZ+lxMUGSccyfwKyPJW13n0wxBAoKT23HDVFNCxaD9YX6VRzPRR/wDkQYLpEgaqg0hX8s2J5C8rZKIg/xoOQRxlawzfSLnHCZD8Tc5hQBpKiDOe7BCBHfI/rxbGpw4JLmQio/RG9AtbFc57Cd6XsnDL8RPFto9qZ1FtIin3a6UE9/HTzVlO/uxKe3uhoF08DtV2V6JOdCrx2KkDqiwAmxPPI/eafqujHPgqtFRbge294/mTrgzZqGD1IkESST52GHvaUm/evusrbvKQ0hTZx1aTbOs1u/DpwOaJFypOazK3ZWxSwvDwTFCnwUpfT/Yvq3A9X0aSzTIHrooHKj6ovverkOSmTb3P/GqvhkDQvQPR8KZnYT07o4UmgiSst/35BpVvkhjk7ING2HqNrn+DNhOquA6Ll0vPCTRDS27kl1AFZxv7hbjU9zXEsMB/Awlf1iHdOKcfpHl+OgVWGhNMH6NMwRVXWUbFdedYJfDVTw/Dj1EnxmFYd/h8EYSkL91USq1GoWyk7859nRyGCTS/c9vSFfBDbcKwnp5RVE4QNcsU1dh3565VkfTlz7QvGzb8dcc0Qr6kbJzBWUG4ZnqmAl7cnc
X-Forefront-Antispam-Report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:GVYP280MB0464.SWEP280.PROD.OUTLOOK.COM; PTR:; CAT:NONE; SFS:(13230001)(4636009)(366004)(966005)(316002)(2906002)(508600001)(66946007)(6512007)(33964004)(4326008)(36756003)(31686004)(6506007)(44832011)(8676002)(53546011)(26005)(66556008)(8936002)(21480400003)(5660300002)(31696002)(86362001)(235185007)(6486002)(110136005)(66476007)(83380400001)(38100700002)(186003)(2616005)(43740500002)(45980500001); DIR:OUT; SFP:1101;
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0: R1nJXi5+3SW2uZBh40nV7GDmB29pPfPXO61d1v71Rmfp5K54tWVqqPIZ7u4YQ2ajz5YO1vAajoOT+1Gui08hyZzDzERaEwhEGvHeBrqRTz1x9oqSCKQfophMU7sddfZBnkI8RmK0Dcsg2Ypz80Vl8Id3bNHAuaSFCImvgNiWXr9eUfgzRb7WpYvw19l76k6yvELQ72z3zQn3Pw2Hz3f4nwjc+E5/gRWachg0KcZXMEZ1JPJXFT07o6gwYD3N69E+MzJWzijCVZP/VXyZ8hx9T5JHQGJjXm59ftQ3/AE6l2lSXT+lDYBSF3lhd/V/gILdIWF3pgRlTvItP8y6m1WHAYV1JwEaX+xWLCbS3+nMu3ut+mUzI581yLNdFKRwf+lAWp14PsqThwAic0DyrtDorlKGHGX6Ej7QThOWcD0KN8pLxA9atBiV7qn8aEGp5Sdmv1HmWxR5hNOmAsVANNfXoOZ8vdi1CJZ/qEn6zpzXM0HMWgNd/w7PN5fRK3yHZ26w7Bv3ZIS9amVJrRpj7yw1cC/7LGk0U7u7eZ1wv2Omu0Fks8LyMa8RMd9N2MnwhvZvx1j82j9IiDLbukCy+BbIGTttvnJ/971SwCPOWVDUiknjJAz22h13O+bihDK4ul7OnxqbW/FW6KtVzAWiQuwWN3D1JeO+948AW+9rFb809/o1aK838Zdu1JkLnuRK0FJ2NbWLgJF8EcN8jO+C3lAXLaIdoYnF/y1Cmt69RXi1+iLa0kZdfk4AI+/RS5lfx4OXN3YK/0MzTmvbBZ4Bm08FxMrEJPaEhTw/camc7kOlAnrYHtNf4UzdMGQzFDndqcYYADey6v+yIbNZkwtKGOqnEk0ERI8xdnATqK2rZTcKTUXAUsWEX43koxrnmKMvJmXpVxio9U92o+KXwMzwJFk9nRC2UB7R4JUVrA/TW98mx4U9fSPO/5WHOm5MR+0J5+NI84xGYlilqgEa9xI3S7FllnqWZ/C2PSHvOHjk5pWCzu0FRsfjXTRCTtoqPxxbhjjWzVAmzFvXbyRwF5/iJwfDNpdbCYV6AmWb/2ay8yd9wqKBpLd74nZPjZaAfy3cVYqfi0kwTGu9GyZUUuIiqJe8ZODR91gVACAZ6H0/8t6HINKpnTCVoviHO2r+hS6apYJJuP31HAs6LbOIIjLVMW1Qch7Rb8ucsilJFvItyhmw1aSAgjw5KUGfnBexwNKDvdPqV2cNtSMs/QILYd/M0slhpGsP0wNAHnAOLSsPdHJPNzF/xk6c5mMo0g/xoZXmBdUumRZOU6/aTS9ahRgsFPNIpzSQxzlhcNxhthL20ZY1KT8uxUaIQbasaT+tfV7E5EEPByG45tFHQdfjCIXUT3dS2VfSaKwdh20JZ6X4keYH8lkhSn2Z1uaSI1uxgm8c7uF7J9HavWbU5PHhdrIvVHVwoBAlQuct7UpqTBcmJYIqCoZq1kbtsm8O70OwU0+Qd/vlwoD/u84VirvanQFt5kCNj3M80nv4unYT32KH13BTAtp6tgwr1Erly3ougJm5jBmGvoFaJ2qFrsJuXGPiZ/YMhASlVgPaafvbA2by0EnxEjIs7t+2aIFkAj1T0KlHfCIYN5nnhYjLG5kmgGVeRIaA9QOWa5rOhubD/TG41Jsg5HXNDVEVoDToaaLmy/EnYZCo8F0IIRarTOQtEc2BbdI9+aRfKx/W6KDRjWbOowr6a1oen/VlJLbSz5f6q3oED3/9zGpXoDGAhyfnRvM890rsPg==
X-OriginatorOrg: ri.se
X-MS-Exchange-CrossTenant-Network-Message-Id: 644cc69e-da8c-482e-ed95-08da37104c38
X-MS-Exchange-CrossTenant-AuthSource: GVYP280MB0464.SWEP280.PROD.OUTLOOK.COM
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 16 May 2022 07:47:16.5556 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: 5a9809cf-0bcb-413a-838a-09ecc40cc9e8
X-MS-Exchange-CrossTenant-MailboxType: HOSTED
X-MS-Exchange-CrossTenant-UserPrincipalName: jerQ826DKeHzAi2IxaDWbnjRL7w4uhKrGQaScmGkL/9NnaOh+KJgPf2+yzEWxh80TZ++jEOktfHT77rqcFn8bw==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: GVYP280MB0208
Archived-At: <https://mailarchive.ietf.org/arch/msg/core/7_Oqt82j4tl69IG6--FrSoRN8uQ>
Subject: Re: [core] WG Last Call on draft-ietf-core-problem-details
X-BeenThere: core@ietf.org
X-Mailman-Version: 2.1.34
Precedence: list
List-Id: "Constrained RESTful Environments \(CoRE\) Working Group list" <core.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/core>, <mailto:core-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/core/>
List-Post: <mailto:core@ietf.org>
List-Help: <mailto:core-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/core>, <mailto:core-request@ietf.org?subject=subscribe>
X-List-Received-Date: Mon, 16 May 2022 07:47:27 -0000
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)
- [core] WG Last Call on draft-ietf-core-problem-de… Marco Tiloca
- Re: [core] [httpapi] WG Last Call on draft-ietf-c… Roberto Polli
- Re: [core] [Cbor] [httpapi] WG Last Call on draft… Carsten Bormann
- Re: [core] [Cbor] [httpapi] WG Last Call on draft… Roberto Polli
- Re: [core] WG Last Call on draft-ietf-core-proble… Marco Tiloca
- Re: [core] WG Last Call on draft-ietf-core-proble… Thomas Fossati
- Re: [core] [Cbor] WG Last Call on draft-ietf-core… Carsten Bormann
- Re: [core] WG Last Call on draft-ietf-core-proble… Christian Amsüss
- Re: [core] WG Last Call on draft-ietf-core-proble… Thomas Fossati
- Re: [core] WG Last Call on draft-ietf-core-proble… Christian Amsüss
- Re: [core] [Cbor] WG Last Call on draft-ietf-core… Marco Tiloca
- Re: [core] WG Last Call on draft-ietf-core-proble… Thomas Fossati
- [core] Base-URI Re: [Cbor] WG Last Call on draft-… Carsten Bormann
- [core] "Ignore unknown" -- Re: [Cbor] WG Last Cal… Carsten Bormann
- Re: [core] [Cbor] WG Last Call on draft-ietf-core… Carsten Bormann
- Re: [core] Base-URI Re: [Cbor] WG Last Call on dr… Christian Amsüss