diff --git a/peps/pep-0847.rst b/peps/pep-0847.rst index 2a34ced28c4..297481fe3f6 100644 --- a/peps/pep-0847.rst +++ b/peps/pep-0847.rst @@ -263,7 +263,8 @@ Another option is to diverge from :rfc:`9457`, and pick (or invent) another error format. An argument in favor of this is specificity: a custom error format could, for example, provide dedicated error codes that communicate failure modes that are common/shared -across many index implementations and hosts. +across many index implementations and hosts. Similarly, a custom error +format could represent multiple errors from an index at once. We consider this option unsuitable for two reasons: @@ -272,8 +273,10 @@ We consider this option unsuitable for two reasons: need custom representations for various authorization and authentication error states. #. :rfc:`9457` is *already* extensible, and a future PEP *could* added shared error - codes as a well-known extension in the future. In other words, any foreseeable - benefit from a custom format is already subsumable within the Problem Details format. + codes as a well-known extension in the future. Similarly, :rfc:`9457`'s design + enables multiple interior errors as an extension, per :rfc:`9457#section-3`. + In other words, the benefits of a custom format are already provided by the + Problem Details format. .. _problem-details-appendix-1: