> On Mar 17, 2025, at 7:21 AM, Barry Leiba via Datatracker <nore...@ietf.org>
> wrote:
>
> Reviewer: Barry Leiba
> Review result: Ready with Nits
>
> This document is in good shape and does what it needs to do. I have just one
> very minor substantive comment, and two very nitty nits:
>
> — Section 3.1 —
>
> If the
> "Recommended" column is set to "D" the item is discouraged and
> SHOULD NOT or MUST NOT be used.
>
> That seems a little odd, and I wonder whether some readers of the note (who
> don’t look here for the definition of “D”) might be confused about whether
> it’s
> SHOULD NOT or MUST NOT. Perhaps this?:
>
> NEW-1
> If the "Recommended" column is set to "D" the item is discouraged and SHOULD
> NOT or MUST NOT be used; consult the item’s references to understand the
> situation. END
>
> …or maybe…
>
> NEW-2
> If the "Recommended" column is set to "D" the item is discouraged and SHOULD
> NOT or MUST NOT be used, depending upon the situation; consult the item’s
> references for clarity. END
Fixed via: https://github.com/tlswg/rfc8447bis/pull/72/files
<https://github.com/tlswg/rfc8447bis/pull/7/files>
> — Section 3 —
>
> Nit in the definition of “N”: “leave an items” -> “leave an item”.
Fixed via: https://github.com/tlswg/rfc8447bis/pull/70/files
> Also “basis of it having” -> “basis of its having”, as standard practice uses
> possessive pronouns with gerunds.
Fixed via: https://github.com/tlswg/rfc8447bis/pull/72/files
<https://github.com/tlswg/rfc8447bis/pull/7/files>
Cheers,
spt
_______________________________________________
TLS mailing list -- tls@ietf.org
To unsubscribe send an email to tls-le...@ietf.org
