[OAUTH-WG] Re: Nit in section 4 of draft 13 of SD-JWT

Travis Spencer <travis@curity.io> Fri, 25 October 2024 08:03 UTC

Return-Path: <travis.spencer@curity.io>
X-Original-To: oauth@ietfa.amsl.com
Delivered-To: oauth@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id D3108C15198F for <oauth@ietfa.amsl.com>; Fri, 25 Oct 2024 01:03:53 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.105
X-Spam-Level:
X-Spam-Status: No, score=-2.105 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, RCVD_IN_DNSWL_BLOCKED=0.001, 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=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=curity.io
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 IMtEg3TFOxoz for <oauth@ietfa.amsl.com>; Fri, 25 Oct 2024 01:03:49 -0700 (PDT)
Received: from mail-lj1-x22d.google.com (mail-lj1-x22d.google.com [IPv6:2a00:1450:4864:20::22d]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature ECDSA (P-256) server-digest SHA256) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id A98E3C169413 for <oauth@ietf.org>; Fri, 25 Oct 2024 01:03:49 -0700 (PDT)
Received: by mail-lj1-x22d.google.com with SMTP id 38308e7fff4ca-2fb3ce15172so26278541fa.0 for <oauth@ietf.org>; Fri, 25 Oct 2024 01:03:49 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=curity.io; s=google; t=1729843427; x=1730448227; darn=ietf.org; h=content-transfer-encoding:cc:to:subject:message-id:date:from :in-reply-to:references:mime-version:from:to:cc:subject:date :message-id:reply-to; bh=4clQv+JRhiSQnB456H/EV/L3wW6DbuWvZhFxSJozCm8=; b=X8N8wtj5V2zzH5mn9CRNuQde0kNBYGIl/HUeRl2umMRI9M1hGeJ0veOecxUBL0p+G3 rl/GUnGMFV/8MpCwcJyBnjYjWwZZc/ifBB0LmV3hu+Chm5bwvK/oAqnbEuCQl/FGySa7 lzWOt2fcXnX1JjroZduDljCKoh5x1k2capRJeLw20roZsMwzpxOt/UTjabeR7S3IzBWO AwgwG07aKnp7+HpIicyJ7dvX4sVTuVXTynrX9X5embrZt47KQjsUsu/HB/HVPYPTbxuy tjbLcgY27YOlKks0kF/MDovdsSL82PUsf7nLT9evqpKUhsgJAtvSCOz84lzN0xhzPsxA x/lw==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1729843427; x=1730448227; h=content-transfer-encoding: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=4clQv+JRhiSQnB456H/EV/L3wW6DbuWvZhFxSJozCm8=; b=uwLWaXa2+QBOraS2c9lFLRIj/5NcOyKW+Gs9LLat6A/VmyFQxysQdC2M0TVEzcsQPC N3fmE0jQOiZrw04mK87kRmUbuTfEpTShd0WigioDAb1QBaAJsgiXEf2IiWB+bjfadNJg tYJGRuySemNf+TCDqDD4vOyWJ5P/tSk51z5CO0wrxIuy8jNWhNBX0Mas8N50bwWbwFIe JR3H9i95zUDpFs+kW+IZt9nhdCz1MuE11mDkfGuzhSaGCG13bG/cAILgDkYbp1Penkwo CyEvkCffhO7YdgMNKnG4Ul6LORKvzYioa8NSLPPtifcwvizzwyF/JGmLryIFmF+3FjVE eCfw==
X-Forwarded-Encrypted: i=1; AJvYcCVjZpO4080XkMUaUDitbAXtzZG37C7+KEJtJxrsjw+kGSQW2fvmZRWQa3jesNOqRrJxUBa+KQ==@ietf.org
X-Gm-Message-State: AOJu0Yy7XfNSN7jH9SE5A7PTWjlPKuIqZDgxxhn9INR7ZXnRFR0pij9D Ht20armpiRUnpxjV8jPOEAWfA8Yjex9OTqm/Oy8+J121W7gFnbYgk1PU2UQ1BAbr55OxNNDntHB o+JMqISfChSl+wWn4LyMj+ElkERQsRsOsSvNp4Wy+Xc0WJw1G/dY=
X-Google-Smtp-Source: AGHT+IHMNZIUrRVL8Sh45sLJem9HUPOmEPU3dOjF+h8Lf89eu6ZF/GFL4WPSYP5G3IJOv9cDa/vB2AymL/SkfeVBP28=
X-Received: by 2002:a05:6512:3c8e:b0:539:fc1b:36d1 with SMTP id 2adb3069b0e04-53b236a68f7mr1856358e87.6.1729843427135; Fri, 25 Oct 2024 01:03:47 -0700 (PDT)
MIME-Version: 1.0
References: <CAEKOcs32HCRh5oZTjvjso9sFV3bsMm48tfDsdXsrC5S++kam3g@mail.gmail.com> <CA+k3eCSxxkEUzDKgbd3ueh-newLyvOODfo4d2kNvbk2Wt1X3Lw@mail.gmail.com> <CAJot-L2ji4+YVTCJ8ssS5YyaESBiYxTDK-7U30+5pGVNuLCQCA@mail.gmail.com>
In-Reply-To: <CAJot-L2ji4+YVTCJ8ssS5YyaESBiYxTDK-7U30+5pGVNuLCQCA@mail.gmail.com>
From: Travis Spencer <travis@curity.io>
Date: Fri, 25 Oct 2024 10:03:36 +0200
Message-ID: <CAEKOcs0RO8GzVfvwn-jR2bn+-H71CqykVT3waF3s4_OgaPK1KQ@mail.gmail.com>
To: Warren Parad <wparad=40rhosys.ch@dmarc.ietf.org>
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable
Message-ID-Hash: U274R5T56J34WHEREVKE6CNX4ZPLABF3
X-Message-ID-Hash: U274R5T56J34WHEREVKE6CNX4ZPLABF3
X-MailFrom: travis.spencer@curity.io
X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; emergency; loop; banned-address; member-moderation; header-match-oauth.ietf.org-0; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; digests; suspicious-header
CC: oauth <oauth@ietf.org>
X-Mailman-Version: 3.3.9rc6
Precedence: list
Subject: [OAUTH-WG] Re: Nit in section 4 of draft 13 of SD-JWT
List-Id: OAUTH WG <oauth.ietf.org>
Archived-At: <https://mailarchive.ietf.org/arch/msg/oauth/PIYxisMXmYEp-owi-G3CfKNX6Is>
List-Archive: <https://mailarchive.ietf.org/arch/browse/oauth>
List-Help: <mailto:oauth-request@ietf.org?subject=help>
List-Owner: <mailto:oauth-owner@ietf.org>
List-Post: <mailto:oauth@ietf.org>
List-Subscribe: <mailto:oauth-join@ietf.org>
List-Unsubscribe: <mailto:oauth-leave@ietf.org>

"for those that celebrate" should be offset by commas on each side,
https://www.grammarly.com/blog/punctuation-capitalization/comma-with-interrupters/.
The draft is correct in this regard.

I think many readers, however, will read "celebrate ABNF" (missing the
trailing comma) and get confused because they ended the interrupting
phrase in the wrong place.

On Fri, Oct 25, 2024 at 9:22 AM Warren Parad
<wparad=40rhosys.ch@dmarc.ietf.org> wrote:
>>
>> Little attempts at satire, like this one, that poke fun at the occasional absurdity involved in standards development work help me keep it together in the face of the occasional absurdity.
>
>
> I totally agree, I've always found the opportunities to add enjoyment to the consuming of the specs to be appreciated. I will say that I can't actually decide if the comma belongs or not though.
>
> On Fri, Oct 25, 2024 at 1:11 AM Brian Campbell <bcampbell=40pingidentity.com@dmarc.ietf.org> wrote:
>>
>> The phrase "for those who celebrate" there is a subtle attempt at a little bit of good-natured humor. ChatGPT explains the general phrase thusly:
>>
>> The phrase "for those who celebrate" is often used to acknowledge that not everyone may participate in a particular holiday, event, or tradition. It's a way of being inclusive and respectful of diverse beliefs, practices, and customs. For example, saying "Happy Holidays to those who celebrate" recognizes that while some people may be celebrating a specific holiday, others may not observe it or may celebrate different holidays.
>>
>> The meaning in the context of this document is to playfully acknowledge that some people really like ABNF while others aren't readily familiar with it and/or don't find it particularly useful. The former are those who celebrate. The latter are those who do not. The document is inclusive of all.
>>
>> This lighthearted reference also reflects the journey of how ABNF came to be included in the document. Seen here: https://github.com/oauth-wg/oauth-selective-disclosure-jwt/issues/393, there was initially a suggestion that including ABNF would be helpful for implementers. Even though this was met with some skepticism about how many people would actually find it useful, it was added to the document anyway.
>>
>> Of course, if a joke requires explanation, it tends to lose its humor. Nevertheless, I remain partial to the text. Little attempts at satire, like this one, that poke fun at the occasional absurdity involved in standards development work help me keep it together in the face of the occasional absurdity.
>>
>>
>>
>>
>>
>> On Thu, Oct 24, 2024 at 1:54 AM Travis Spencer <travis=40curity.io@dmarc.ietf.org> wrote:
>>>
>>> Section 4 of draft 13 of the SD-JWT WG document says:
>>>
>>> As an alternative illustration of the SD-JWT format, for those who celebrate,
>>> ABNF [RFC5234] for the SD-JWT, SD-JWT+KB, and various constituent parts
>>> is provided here:
>>>
>>> Who are those who celebrate? Those that celebrate birthdays,
>>> Midsummer, Halloween? I don't understand and think that phrase should
>>> be deleted.
>>>
>>> Suggested alternative:
>>>
>>> As an alternative illustration of the SD-JWT format in ABNF [RFC5234] for
>>> the SD-JWT, SD-JWT+KB, and various constituent parts is provided here:
>>>
>>> HTH!
>>>
>>> _______________________________________________
>>> OAuth mailing list -- oauth@ietf.org
>>> To unsubscribe send an email to oauth-leave@ietf.org
>>
>>
>> CONFIDENTIALITY NOTICE: This email may contain confidential and privileged material for the sole use of the intended recipient(s). Any review, use, distribution or disclosure by others is strictly prohibited.  If you have received this communication in error, please notify the sender immediately by e-mail and delete the message and any file attachments from your computer. Thank you._______________________________________________
>> OAuth mailing list -- oauth@ietf.org
>> To unsubscribe send an email to oauth-leave@ietf.org