Re: [auth48] AUTH48: RFC-to-be 9457 <draft-ietf-httpapi-rfc7807bis-07> for your review
Sanjay Dalal <sanjay.dalal@cal.berkeley.edu> Wed, 26 July 2023 18:51 UTC
Return-Path: <sanjay.dalal@gmail.com>
X-Original-To: auth48archive@ietfa.amsl.com
Delivered-To: auth48archive@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id D2DF2C1595FE; Wed, 26 Jul 2023 11:51:50 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.405
X-Spam-Level:
X-Spam-Status: No, score=-1.405 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, FREEMAIL_FORGED_FROMDOMAIN=0.25, FREEMAIL_FROM=0.001, HEADER_FROM_DIFFERENT_DOMAINS=0.249, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_ZEN_BLOCKED_OPENDNS=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01, URIBL_BLOCKED=0.001, URIBL_DBL_BLOCKED_OPENDNS=0.001, URIBL_ZEN_BLOCKED_OPENDNS=0.001] autolearn=no autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=berkeley.edu
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 FNew9BBAMmoi; Wed, 26 Jul 2023 11:51:46 -0700 (PDT)
Received: from mail-io1-xd2b.google.com (mail-io1-xd2b.google.com [IPv6:2607:f8b0:4864:20::d2b]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 56191C169538; Wed, 26 Jul 2023 11:51:46 -0700 (PDT)
Received: by mail-io1-xd2b.google.com with SMTP id ca18e2360f4ac-7835971026fso3043339f.3; Wed, 26 Jul 2023 11:51:46 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=berkeley.edu; s=google; t=1690397505; x=1691002305; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:from:to:cc:subject:date:message-id:reply-to; bh=UOyWGjqGvkpVAsKct9Bw2aXxTzLWYdMFD5+mwN8P+Lk=; b=fEAdiqQuj3IjpoB/g0zkHwUhqRVuMbD/ZI7AfKwE+aAInimK0kaUYhU6JdsqUeMfF2 /9nJGCjC0+2wu6TMk+/jOtISevUGgtP4NBqfADWpX8CmOKufE6tgNkCF35RKSuz5pkWm DAh58cRAZNN79mcs2FJKGWzsMPgtlJzC8tpC+chz4xK7zJRe8RTfSj2T+Nbbf5mTi5gy Q0Xj+W+9O3wdH7sN3EmI5vaT7icgbtPoF6XTyIYCEXg/OIXPPiUlw7zqgjdSgh2i+1Ev MXP/14eBFIsjS9vC24PHUCyJ5gpJr9s1S8FkcE1yWPcmDCWfXMAfkn4bayFk+WvPLGQD juYg==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1690397505; x=1691002305; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=UOyWGjqGvkpVAsKct9Bw2aXxTzLWYdMFD5+mwN8P+Lk=; b=HJvXKlO6pvCtAoL7eAiUEG3a3zY9Ko2kAZODe/8jcWeLE3rx/R4f/xIwCVji94G1gf X8Qn8QeryMv/ijYWTBR36NOwQnu6Beey8r0XEFe+MtuDIR7CyXxE9mI6V5n7Zkt/QnrW Wq1Vmpj8WB97Tpy6mMZGCIKAwXgg1nNIFtVkl8POGUo2DD1B4PSt5Ac05ES5IELgcvAy ZDbkuahz3vMdQUNuXDFYXTi7U9bcvFnRP2PRPhpwxenpdM5qTiX0crmRkDle2e6k9dWY WybN7wVVxZEqejBQqHHSLV1TQCGNVaCzHcCc46AfD+ea8fbIf5i3OwRXScUF/7i1igLO 7zEw==
X-Gm-Message-State: ABy/qLYOpHPJ3mzo0XhMnQY+KhlMErA/CBbSVnYcB5OOdz/sLKycmdAv IJWYcRZRKC5O54EOoX3+Ckmx8oMWniInvf+C8gc=
X-Google-Smtp-Source: APBJJlH1z+Won5snR58ENpQwqSJZAqhip1gsDUn6MYBYLi6rXD1flzVOg0nZEqA/X1r6vs00wmeFW7SEXb54dUMLWQg=
X-Received: by 2002:a05:6e02:118e:b0:346:49bd:7b6c with SMTP id y14-20020a056e02118e00b0034649bd7b6cmr2585601ili.22.1690397504521; Wed, 26 Jul 2023 11:51:44 -0700 (PDT)
MIME-Version: 1.0
References: <20230720210004.24BE64C1A1@rfcpa.amsl.com> <8B41145B-F527-44D1-ABD7-0A58F6128B9F@mnot.net> <B48A2D61-1E01-481A-827A-C8FFD24803A9@amsl.com> <5E825791-83A0-458B-BBEA-6FA2B826A39B@amsl.com> <D44C0D2B-19F5-4BFC-BBC4-AC5C4329114C@mnot.net> <98CF652D-AA98-4A1A-9BCA-6456D57D346C@amsl.com> <6DA6EE12-3241-4094-BBCB-255BCCDA3F02@amsl.com> <90F9631E-E494-45B2-88CF-FA8469B4E6CC@mnot.net> <8B8AA778-0635-45D6-A271-35C74500B3BC@amsl.com>
In-Reply-To: <8B8AA778-0635-45D6-A271-35C74500B3BC@amsl.com>
From: Sanjay Dalal <sanjay.dalal@cal.berkeley.edu>
Date: Wed, 26 Jul 2023 11:51:33 -0700
Message-ID: <CAC5fHGN0CKpPHf=emdEdoj6QGhxNcgA4W9Bv+5UBVnqe=VznWw@mail.gmail.com>
To: Karen Moore <kmoore@amsl.com>
Cc: Mark Nottingham <mnot@mnot.net>, Erik Wilde <erik.wilde@dret.net>, Mark Nottingham <mnot=40mnot.net@dmarc.ietf.org>, RFC Editor <rfc-editor@rfc-editor.org>, httpapi-ads@ietf.org, httpapi-chairs@ietf.org, Darrel Miller <darrel@tavis.ca>, "Murray S. Kucherawy" <superuser@gmail.com>, auth48archive@rfc-editor.org
Content-Type: multipart/alternative; boundary="000000000000c94bf606016856ff"
Archived-At: <https://mailarchive.ietf.org/arch/msg/auth48archive/dT0x2Pum5CycrXg2MbigCxucMKE>
Subject: Re: [auth48] AUTH48: RFC-to-be 9457 <draft-ietf-httpapi-rfc7807bis-07> for your review
X-BeenThere: auth48archive@rfc-editor.org
X-Mailman-Version: 2.1.39
Precedence: list
List-Id: "Archiving AUTH48 exchanges between the RFC Production Center, the authors, and other related parties" <auth48archive.rfc-editor.org>
List-Unsubscribe: <https://mailman.rfc-editor.org/mailman/options/auth48archive>, <mailto:auth48archive-request@rfc-editor.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/auth48archive/>
List-Post: <mailto:auth48archive@rfc-editor.org>
List-Help: <mailto:auth48archive-request@rfc-editor.org?subject=help>
List-Subscribe: <https://mailman.rfc-editor.org/mailman/listinfo/auth48archive>, <mailto:auth48archive-request@rfc-editor.org?subject=subscribe>
X-List-Received-Date: Wed, 26 Jul 2023 18:51:50 -0000
+1 from me. Thank you Karen and everyone. On Wed, Jul 26, 2023 at 11:14 AM Karen Moore <kmoore@amsl.com> wrote: > Great! Type “rnc” is now reflected in our files. > > Awaiting all author approvals before moving this document through the > publication process. > > FILES (please refresh): > > The updated XML file is here: > https://www.rfc-editor.org/authors/rfc9457.xml > > The updated output files are here: > https://www.rfc-editor.org/authors/rfc9457.txt > https://www.rfc-editor.org/authors/rfc9457.pdf > https://www.rfc-editor.org/authors/rfc9457.html > > This diff file shows all changes made during AUTH48: > https://www.rfc-editor.org/authors/rfc9457-auth48diff.html > > This diff file shows all changes made to date: > https://www.rfc-editor.org/authors/rfc9457-diff.html > > For the AUTH48 status of this document, please see: > https://www.rfc-editor.org/auth48/rfc9457 > > Best, > RFC Editor/kc > > > > On Jul 26, 2023, at 11:05 AM, Mark Nottingham <mnot@mnot.net> wrote: > > > > Yes, thank you! > > > >> On 26 Jul 2023, at 10:28 am, Karen Moore <kmoore@amsl.com> wrote: > >> > >> Hello authors, > >> > >> For the sourcecode in Appendix B, would it be agreeable to use “rnc” > for the type? This is on the list of preferred types ( > https://www.rfc-editor.org/materials/sourcecode-types.txt), and it stands > for "Relax NG Compact”. > >> > >> Thanks, > >> RFC Editor/kc > >> > >>> On Jul 25, 2023, at 5:55 PM, Karen Moore <kmoore@amsl.com> wrote: > >>> > >>> Hi Mark, > >>> > >>> We have changed "problem(s) encountered" to "problem encountered” in > the Introduction. > >>> > >>> FILES (please refresh) > >>> > >>> The updated XML file is here: > >>> https://www.rfc-editor.org/authors/rfc9457.xml > >>> > >>> The updated output files are here: > >>> https://www.rfc-editor.org/authors/rfc9457.txt > >>> https://www.rfc-editor.org/authors/rfc9457.pdf > >>> https://www.rfc-editor.org/authors/rfc9457.html > >>> > >>> This diff file shows all changes made during AUTH48: > >>> https://www.rfc-editor.org/authors/rfc9457-auth48diff.html > >>> > >>> This diff file shows all changes made to date: > >>> https://www.rfc-editor.org/authors/rfc9457-diff.html > >>> > >>> For the AUTH48 status of this document, please see: > >>> https://www.rfc-editor.org/auth48/rfc9457 > >>> > >>> Best, > >>> RFC Editor/kc > >>> > >>> > >>>> On Jul 25, 2023, at 2:00 PM, Mark Nottingham <mnot@mnot.net> wrote: > >>>> > >>>> Thank you. > >>>> > >>>> One immediate change: could you please change "problem(s) > encountered" to "problem encountered" in the Introduction? > >>>> > >>>> Cheers, > >>>> > >>>> > >>>>> On 25 Jul 2023, at 12:25 pm, Karen Moore <kmoore@amsl.com> wrote: > >>>>> > >>>>> Hi Mark, > >>>>> > >>>>> This change is now reflected in our files. Note that we will get > back to you shortly regarding the sourcecode type for the code in Appendix > B. Aside from that, please feel free to provide further changes (if needed) > and approvals. > >>>>> > >>>>> FILES (please refresh) > >>>>> > >>>>> The updated XML file is here: > >>>>> https://www.rfc-editor.org/authors/rfc9457.xml > >>>>> > >>>>> The updated output files are here: > >>>>> https://www.rfc-editor.org/authors/rfc9457.txt > >>>>> https://www.rfc-editor.org/authors/rfc9457.pdf > >>>>> https://www.rfc-editor.org/authors/rfc9457.html > >>>>> > >>>>> This diff file shows all changes made during AUTH48: > >>>>> https://www.rfc-editor.org/authors/rfc9457-auth48diff.html > >>>>> > >>>>> This diff file shows all changes made to date: > >>>>> https://www.rfc-editor.org/authors/rfc9457-diff.html > >>>>> > >>>>> For the AUTH48 status of this document, please see: > >>>>> https://www.rfc-editor.org/auth48/rfc9457 > >>>>> > >>>>> Thank you, > >>>>> > >>>>> RFC Editor/kc > >>>>> > >>>>> > >>>>>> On 24 Jul 2023, at 7:02 pm, Karen Moore <kmoore@amsl.com> wrote: > >>>>>> > >>>>>> Perhaps: > >>>>>> Extension arrays and objects are serialized into the XML format by > >>>>>> considering an element containing a child or children to represent > an > >>>>>> object, except for elements containing only one or more child > elements > >>>>>> named "i"', which are considered arrays. > >>>>> > >>>>> LGTM, thanks! > >>>>> > >>>>> -- > >>>>> Mark Nottingham https://www.mnot.net/ > >>>>> > >>>>>> On Jul 24, 2023, at 7:02 PM, Karen Moore <kmoore@amsl.com> wrote: > >>>>>> > >>>>>> Hi Mark, > >>>>>> > >>>>>> Thank you for your reply. We have updated our files accordingly. We > have a few more questions/clarifications. > >>>>>> > >>>>>> 1) FYI: We changed “Notational Conventions” to “Requirements > Language” to follow RFC 7807 more closely (it's author choice here, but > FWIW, 285 RFCs use “Notational Conventions" and 1465 use “Requirements > Language”). > >>>>>> > >>>>>> 2) There is currently no guidance in the style guide about how > terms with “(s)” are read. The Chicago Manual of Style recommends > rephrasing for clarity. Please let us know if the following update may be > agreeable. > >>>>>> > >>>>>>>> b) Since "element(s)" is read as singular, we updated "only child > >>>>>>>> element(s)" to "only a child element(s)" and "which are...arrays" > to > >>>>>>>> "which is...an array". > >>>>>>> > >>>>>>> [MN] Personally, I read foo(s) as plural, not singular. Is this > something in a style guide somewhere? > >>>>>> > >>>>>> > >>>>>> Perhaps: > >>>>>> Extension arrays and objects are serialized into the XML format by > >>>>>> considering an element containing a child or children to represent > an > >>>>>> object, except for elements containing only one or more child > elements > >>>>>> named "i"', which are considered arrays. > >>>>>> > >>>>>> 3) We have removed type “html” from the sourcecode, and we are > checking on the use of “relax-ng-compact-syntax”; we will get back to you > shortly on this. > >>>>>> > >>>>>> > >>>>>> FILES > >>>>>> The updated XML file is here: > >>>>>> https://www.rfc-editor.org/authors/rfc9457.xml > >>>>>> > >>>>>> The updated output files are here: > >>>>>> https://www.rfc-editor.org/authors/rfc9457.txt > >>>>>> https://www.rfc-editor.org/authors/rfc9457.pdf > >>>>>> https://www.rfc-editor.org/authors/rfc9457.html > >>>>>> > >>>>>> This diff file shows all changes made during AUTH48: > >>>>>> https://www.rfc-editor.org/authors/rfc9457-auth48diff.html > >>>>>> > >>>>>> This diff file shows all changes made to date: > >>>>>> https://www.rfc-editor.org/authors/rfc9457-diff.html > >>>>>> > >>>>>> Note that it may be necessary for you to refresh your browser to > view the most recent version. Please review the document carefully to > ensure satisfaction as we do not make changes once it has been published as > an RFC. > >>>>>> > >>>>>> Please contact us with any further updates or with your approval of > the document in its current form. We will await approvals from each author > prior to moving forward in the publication process. > >>>>>> > >>>>>> For the AUTH48 status of this document, please see: > >>>>>> https://www.rfc-editor.org/auth48/rfc9457 > >>>>>> > >>>>>> Thank you, > >>>>>> > >>>>>> RFC Editor/kc > >>>>>> > >>>>>> > >>>>>>> On Jul 21, 2023, at 10:57 AM, Mark Nottingham <mnot= > 40mnot.net@dmarc.ietf.org> wrote: > >>>>>>> > >>>>>>> > >>>>>>> > >>>>>>>> On 20 Jul 2023, at 2:00 pm, rfc-editor@rfc-editor.org wrote: > >>>>>>>> > >>>>>>>> Authors, > >>>>>>>> > >>>>>>>> While reviewing this document during AUTH48, please resolve (as > necessary) the following questions, which are also in the XML file. > >>>>>>>> > >>>>>>>> 1) <!-- [rfced] Section 1. RFC 7807 is mentioned in the running > text, but > >>>>>>>> there is no corresponding entry in the References section. We > >>>>>>>> have added the reference entry to the Informative References > >>>>>>>> section; please let us know of any objections. > >>>>>>>> > >>>>>>>> Original: > >>>>>>>> See Appendix D for a list of changes from RFC 7807. > >>>>>>>> > >>>>>>>> Current: > >>>>>>>> See Appendix D for a list of changes from [RFC7807]. > >>>>>>>> --> > >>>>>>> > >>>>>>> That's fine. > >>>>>>> > >>>>>>> > >>>>>>>> 2) <!--[rfced] Would you like to update the title of Section 2 > from > >>>>>>>> "Notational Conventions" to "Requirements Language" since the > >>>>>>>> latter form is used more frequently in RFCs, plus it will match > >>>>>>>> RFC 7807 more closely (which uses "Requirements")? > >>>>>>>> > >>>>>>>> Original: > >>>>>>>> 2. Notational Conventions > >>>>>>>> > >>>>>>>> Perhaps: > >>>>>>>> 2. Requirements Language > >>>>>>>> --> > >>>>>>> > >>>>>>> My experience is that 'notational conventions' is more common, but > maybe that's just the corner of the RFC Series that I inhabit. > >>>>>>> > >>>>>>> Sure. > >>>>>>> > >>>>>>> > >>>>>>>> 3) <!-- [rfced] While we understand the original document was > published with the text > >>>>>>>> we are questioning below, the questions are aimed at making the > text as > >>>>>>>> correct as possible. Please let us know if these updates are > incorrect or > >>>>>>>> undesirable. > >>>>>>>> > >>>>>>>> a) Should "A problem's type URI" be "A problem type URI" (similar > to "A problem > >>>>>>>> type definition" in the next paragraph)? Please let us know > if/how we may update. > >>>>>>>> > >>>>>>>> Original: > >>>>>>>> A problem's type URI SHOULD resolve to HTML [HTML5] documentation > >>>>>>>> that explains how to resolve the problem. > >>>>>>>> > >>>>>>>> A problem type definition MAY specify... > >>>>>>>> > >>>>>>>> Perhaps: > >>>>>>>> A problem type URI SHOULD resolve to HTML [HTML5] documentation > >>>>>>>> that explains how to resolve the problem. > >>>>>>>> > >>>>>>>> A problem type definition MAY specify... > >>>>>>> > >>>>>>> Yes please. > >>>>>>> > >>>>>>> > >>>>>>>> b) Since "element(s)" is read as singular, we updated "only child > >>>>>>>> element(s)" to "only a child element(s)" and "which are...arrays" > to > >>>>>>>> "which is...an array". > >>>>>>>> > >>>>>>>> Original: > >>>>>>>> Extension arrays and objects are serialized into the XML format by > >>>>>>>> considering an element containing a child or children to > represent an > >>>>>>>> object, except for elements that contain only child element(s) > named > >>>>>>>> 'i', which are considered arrays. > >>>>>>>> > >>>>>>>> Current: > >>>>>>>> Extension arrays and objects are serialized into the XML format by > >>>>>>>> considering an element containing a child or children to > represent an > >>>>>>>> object, except for elements that contain only a child element(s) > named > >>>>>>>> "i"', which is considered an array. > >>>>>>>> --> > >>>>>>> > >>>>>>> Personally, I read foo(s) as plural, not singular. Is this > something in a style guide somewhere? > >>>>>>> > >>>>>>>> > >>>>>>>> > >>>>>>>> 4) <!--[rfced] Appendix A. May we add a space between "RFC" and > "7807" > >>>>>>>> within the JSON Schema to align with the suggested format in the > >>>>>>>> RFC Style Guide (RFC 7322)? > >>>>>>>> > >>>>>>>> Original: > >>>>>>>> "$schema": "https://json-schema.org/draft/2020-12/schema", > >>>>>>>> "title": "An RFC7807 problem object", > >>>>>>>> > >>>>>>>> Perhaps: > >>>>>>>> "$schema": "https://json-schema.org/draft/2020-12/schema", > >>>>>>>> "title": "An RFC 7807 problem object", > >>>>>>>> --> > >>>>>>> > >>>>>>> Of course. > >>>>>>> > >>>>>>>> > >>>>>>>> > >>>>>>>> 5) <!-- [rfced] Please review the "type" attribute of each > sourcecode > >>>>>>>> element in the XML file to ensure correctness. In particular, > >>>>>>>> "relax-ng-compact-syntax" and "html" need review as they are > >>>>>>>> not in our current list of preferred values for "type" (see > >>>>>>>> <https://www.rfc-editor.org/materials/sourcecode-types.txt>). > >>>>>>>> If this list does not contain an applicable type, feel free to > >>>>>>>> suggest a new one. Also, it is acceptable to leave the "type" > >>>>>>>> attribute not set. > >>>>>>>> --> > >>>>>>> > >>>>>>> It makes sense to omit 'html', but I wonder whether > relax-ng-compact is worth putting in the list. If you think not, best omit > that too. > >>>>>>> > >>>>>>> > >>>>>>>> 6) <!-- [rfced] Terminology > >>>>>>>> > >>>>>>>> a) May we expand "RDFa" and "XSLT" in the text as follows? Please > let us > >>>>>>>> know if this is agreeable or if you prefer otherwise. > >>>>>>>> > >>>>>>>> RDFa > >>>>>>>> Original: > >>>>>>>> or by defining a mapping into RDFa [RDFA]. > >>>>>>>> > >>>>>>>> Current: > >>>>>>>> or by defining a mapping into a Resource Description > >>>>>>>> Framework in Attributes (RDFa) [RDFA]. > >>>>>>>> > >>>>>>>> XSLT > >>>>>>>> Original: > >>>>>>>> When using the XML format, it is possible to embed an XML > processing > >>>>>>>> instruction in the XML that instructs clients to transform the > XML, > >>>>>>>> using the referenced XSLT code [XSLT]. > >>>>>>>> > >>>>>>>> Current: > >>>>>>>> When using the XML format, it is possible to embed an XML > processing > >>>>>>>> instruction in the XML that instructs clients to transform the > XML, > >>>>>>>> using the referenced XSL Transformations (XSLT) code [XSLT]. > >>>>>>> > >>>>>>> That's fine. > >>>>>>> > >>>>>>> > >>>>>>>> ... > >>>>>>>> b) We note that "problem details" appears as lowercase throughout > >>>>>>>> the document, except for 1 instance of "HTTP Problem Details". > Please > >>>>>>>> confirm if this instance is okay as is or if you would like to > make it > >>>>>>>> lowercase for consistency. > >>>>>>>> > >>>>>>>> Original: > >>>>>>>> This section presents a non-normative JSON Schema [JSON-SCHEMA] > for > >>>>>>>> HTTP Problem Details. > >>>>>>>> > >>>>>>>> ... > >>>>>>> > >>>>>>> Lowercase works. > >>>>>>> > >>>>>>> > >>>>>>>> c) For consistency, we updated 1 instance of "HTTP-generic > software" > >>>>>>>> to "generic HTTP software". Please let us know if you prefer > >>>>>>>> otherwise. > >>>>>>>> > >>>>>>>> Original: > >>>>>>>> The API's designer might decide to use > >>>>>>>> the 403 Forbidden status code to inform HTTP-generic software > (such > >>>>>>>> as client libraries, caches, and proxies) of the response's > general > >>>>>>>> semantics. > >>>>>>>> > >>>>>>>> Current: > >>>>>>>> The API's designer might decide to use > >>>>>>>> the 403 Forbidden status code to inform generic HTTP software > (such > >>>>>>>> as client libraries, caches, and proxies) of the response's > general > >>>>>>>> semantics. > >>>>>>>> --> > >>>>>>> > >>>>>>> That's fine. > >>>>>>> > >>>>>>> > >>>>>>> > >>>>>>>> > >>>>>>>> 7) <!-- [rfced] Please review the "Inclusive Language" portion of > the online > >>>>>>>> Style Guide < > https://www.rfc-editor.org/styleguide/part2/#inclusive_language> > >>>>>>>> and let us know if any changes are needed. > >>>>>>>> > >>>>>>>> Note that our script did not flag any words in particular, but > this should > >>>>>>>> still be reviewed as a best practice. > >>>>>>>> --> > >>>>>>> > >>>>>>> Understood. > >>>>>>> > >>>>>>> > >>>>>>> > >>>>>>>> Thank you. > >>>>>>> > >>>>>>> Thank you! > >>>>>>> > >>>>>>> > >>>>>>>> > >>>>>>>> RFC Editor/st/kc > >>>>>>>> > >>>>>>>> > >>>>>>>> On Jul 20, 2023, at 1:57 PM, rfc-editor@rfc-editor.org wrote: > >>>>>>>> > >>>>>>>> *****IMPORTANT***** > >>>>>>>> > >>>>>>>> Updated 2023/07/20 > >>>>>>>> > >>>>>>>> RFC Author(s): > >>>>>>>> -------------- > >>>>>>>> > >>>>>>>> Instructions for Completing AUTH48 > >>>>>>>> > >>>>>>>> Your document has now entered AUTH48. Once it has been reviewed > and > >>>>>>>> approved by you and all coauthors, it will be published as an > RFC. > >>>>>>>> If an author is no longer available, there are several remedies > >>>>>>>> available as listed in the FAQ (https://www.rfc-editor.org/faq/). > >>>>>>>> > >>>>>>>> You and you coauthors are responsible for engaging other parties > >>>>>>>> (e.g., Contributors or Working Group) as necessary before > providing > >>>>>>>> your approval. > >>>>>>>> > >>>>>>>> Planning your review > >>>>>>>> --------------------- > >>>>>>>> > >>>>>>>> Please review the following aspects of your document: > >>>>>>>> > >>>>>>>> * RFC Editor questions > >>>>>>>> > >>>>>>>> Please review and resolve any questions raised by the RFC Editor > >>>>>>>> that have been included in the XML file as comments marked as > >>>>>>>> follows: > >>>>>>>> > >>>>>>>> <!-- [rfced] ... --> > >>>>>>>> > >>>>>>>> These questions will also be sent in a subsequent email. > >>>>>>>> > >>>>>>>> * Changes submitted by coauthors > >>>>>>>> > >>>>>>>> Please ensure that you review any changes submitted by your > >>>>>>>> coauthors. We assume that if you do not speak up that you > >>>>>>>> agree to changes submitted by your coauthors. > >>>>>>>> > >>>>>>>> * Content > >>>>>>>> > >>>>>>>> Please review the full content of the document, as this cannot > >>>>>>>> change once the RFC is published. Please pay particular > attention to: > >>>>>>>> - IANA considerations updates (if applicable) > >>>>>>>> - contact information > >>>>>>>> - references > >>>>>>>> > >>>>>>>> * Copyright notices and legends > >>>>>>>> > >>>>>>>> Please review the copyright notice and legends as defined in > >>>>>>>> RFC 5378 and the Trust Legal Provisions > >>>>>>>> (TLP – https://trustee.ietf.org/license-info/). > >>>>>>>> > >>>>>>>> * Semantic markup > >>>>>>>> > >>>>>>>> Please review the markup in the XML file to ensure that elements > of > >>>>>>>> content are correctly tagged. For example, ensure that > <sourcecode> > >>>>>>>> and <artwork> are set correctly. See details at > >>>>>>>> <https://authors.ietf.org/rfcxml-vocabulary>. > >>>>>>>> > >>>>>>>> * Formatted output > >>>>>>>> > >>>>>>>> Please review the PDF, HTML, and TXT files to ensure that the > >>>>>>>> formatted output, as generated from the markup in the XML file, > is > >>>>>>>> reasonable. Please note that the TXT will have formatting > >>>>>>>> limitations compared to the PDF and HTML. > >>>>>>>> > >>>>>>>> > >>>>>>>> Submitting changes > >>>>>>>> ------------------ > >>>>>>>> > >>>>>>>> To submit changes, please reply to this email using ‘REPLY ALL’ > as all > >>>>>>>> the parties CCed on this message need to see your changes. The > parties > >>>>>>>> include: > >>>>>>>> > >>>>>>>> * your coauthors > >>>>>>>> > >>>>>>>> * rfc-editor@rfc-editor.org (the RPC team) > >>>>>>>> > >>>>>>>> * other document participants, depending on the stream (e.g., > >>>>>>>> IETF Stream participants are your working group chairs, the > >>>>>>>> responsible ADs, and the document shepherd). > >>>>>>>> > >>>>>>>> * auth48archive@rfc-editor.org, which is a new archival mailing > list > >>>>>>>> to preserve AUTH48 conversations; it is not an active discussion > >>>>>>>> list: > >>>>>>>> > >>>>>>>> * More info: > >>>>>>>> > https://mailarchive.ietf.org/arch/msg/ietf-announce/yb6lpIGh-4Q9l2USxIAe6P8O4Zc > >>>>>>>> > >>>>>>>> * The archive itself: > >>>>>>>> https://mailarchive.ietf.org/arch/browse/auth48archive/ > >>>>>>>> > >>>>>>>> * Note: If only absolutely necessary, you may temporarily opt > out > >>>>>>>> of the archiving of messages (e.g., to discuss a sensitive > matter). > >>>>>>>> If needed, please add a note at the top of the message that you > >>>>>>>> have dropped the address. When the discussion is concluded, > >>>>>>>> auth48archive@rfc-editor.org will be re-added to the CC list and > >>>>>>>> its addition will be noted at the top of the message. > >>>>>>>> > >>>>>>>> You may submit your changes in one of two ways: > >>>>>>>> > >>>>>>>> An update to the provided XML file > >>>>>>>> — OR — > >>>>>>>> An explicit list of changes in this format > >>>>>>>> > >>>>>>>> Section # (or indicate Global) > >>>>>>>> > >>>>>>>> OLD: > >>>>>>>> old text > >>>>>>>> > >>>>>>>> NEW: > >>>>>>>> new text > >>>>>>>> > >>>>>>>> You do not need to reply with both an updated XML file and an > explicit > >>>>>>>> list of changes, as either form is sufficient. > >>>>>>>> > >>>>>>>> We will ask a stream manager to review and approve any changes > that seem > >>>>>>>> beyond editorial in nature, e.g., addition of new text, deletion > of text, > >>>>>>>> and technical changes. Information about stream managers can be > found in > >>>>>>>> the FAQ. Editorial changes do not require approval from a stream > manager. > >>>>>>>> > >>>>>>>> > >>>>>>>> Approving for publication > >>>>>>>> -------------------------- > >>>>>>>> > >>>>>>>> To approve your RFC for publication, please reply to this email > stating > >>>>>>>> that you approve this RFC for publication. Please use ‘REPLY > ALL’, > >>>>>>>> as all the parties CCed on this message need to see your approval. > >>>>>>>> > >>>>>>>> > >>>>>>>> Files > >>>>>>>> ----- > >>>>>>>> > >>>>>>>> The files are available here: > >>>>>>>> https://www.rfc-editor.org/authors/rfc9457.xml > >>>>>>>> https://www.rfc-editor.org/authors/rfc9457.html > >>>>>>>> https://www.rfc-editor.org/authors/rfc9457.pdf > >>>>>>>> https://www.rfc-editor.org/authors/rfc9457.txt > >>>>>>>> > >>>>>>>> Diff file of the text: > >>>>>>>> https://www.rfc-editor.org/authors/rfc9457-diff.html > >>>>>>>> https://www.rfc-editor.org/authors/rfc9457-rfcdiff.html (side by > side) > >>>>>>>> > >>>>>>>> Diff of the XML: > >>>>>>>> https://www.rfc-editor.org/authors/rfc9457-xmldiff1.html > >>>>>>>> > >>>>>>>> XMLv3 file that is a best effort to capture v3-related format > updates > >>>>>>>> only: > >>>>>>>> https://www.rfc-editor.org/authors/rfc9457.form.xml > >>>>>>>> > >>>>>>>> > >>>>>>>> Tracking progress > >>>>>>>> ----------------- > >>>>>>>> > >>>>>>>> The details of the AUTH48 status of your document are here: > >>>>>>>> https://www.rfc-editor.org/auth48/rfc9457 > >>>>>>>> > >>>>>>>> Please let us know if you have any questions. > >>>>>>>> > >>>>>>>> Thank you for your cooperation, > >>>>>>>> > >>>>>>>> RFC Editor > >>>>>>>> > >>>>>>>> -------------------------------------- > >>>>>>>> RFC9457 (draft-ietf-httpapi-rfc7807bis-07) > >>>>>>>> > >>>>>>>> Title : Problem Details for HTTP APIs > >>>>>>>> Author(s) : M. Nottingham, E. Wilde, S. Dalal > >>>>>>>> WG Chair(s) : Darrel Miller, Rich Salz > >>>>>>>> Area Director(s) : Murray Kucherawy, Francesca Palombini > >>>>>>>> > >>>>>>>> > >>>>>>>> > >>>>>>> > >>>>>>> -- > >>>>>>> Mark Nottingham https://www.mnot.net/ > >>>>>>> > >>>>>> > >>>>> > >>>> > >>>> -- > >>>> Mark Nottingham https://www.mnot.net/ > >>>> > >>> > >> > > > > -- > > Mark Nottingham https://www.mnot.net/ > > > >
- [auth48] AUTH48: RFC-to-be 9457 <draft-ietf-httpa… rfc-editor
- Re: [auth48] AUTH48: RFC-to-be 9457 <draft-ietf-h… rfc-editor
- Re: [auth48] AUTH48: RFC-to-be 9457 <draft-ietf-h… Mark Nottingham
- Re: [auth48] AUTH48: RFC-to-be 9457 <draft-ietf-h… Karen Moore
- Re: [auth48] AUTH48: RFC-to-be 9457 <draft-ietf-h… Mark Nottingham
- Re: [auth48] AUTH48: RFC-to-be 9457 <draft-ietf-h… Karen Moore
- Re: [auth48] AUTH48: RFC-to-be 9457 <draft-ietf-h… Mark Nottingham
- Re: [auth48] AUTH48: RFC-to-be 9457 <draft-ietf-h… Karen Moore
- Re: [auth48] AUTH48: RFC-to-be 9457 <draft-ietf-h… Karen Moore
- Re: [auth48] AUTH48: RFC-to-be 9457 <draft-ietf-h… Mark Nottingham
- Re: [auth48] AUTH48: RFC-to-be 9457 <draft-ietf-h… Karen Moore
- Re: [auth48] AUTH48: RFC-to-be 9457 <draft-ietf-h… Sanjay Dalal
- Re: [auth48] AUTH48: RFC-to-be 9457 <draft-ietf-h… Karen Moore
- Re: [auth48] AUTH48: RFC-to-be 9457 <draft-ietf-h… Erik Wilde
- Re: [auth48] AUTH48: RFC-to-be 9457 <draft-ietf-h… Karen Moore
- Re: [auth48] AUTH48: RFC-to-be 9457 <draft-ietf-h… Mark Nottingham
- Re: [auth48] AUTH48: RFC-to-be 9457 <draft-ietf-h… Karen Moore