[Last-Call] Artart last call review of draft-ietf-tls-rfc8447bis-11

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



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

— Section 3 —

Nit in the definition of “N”: “leave an items” -> “leave an item”.
Also “basis of it having” -> “basis of its having”, as standard practice uses
possessive pronouns with gerunds.


-- 
last-call mailing list -- last-call@xxxxxxxx
To unsubscribe send an email to last-call-leave@xxxxxxxx




[Index of Archives]     [IETF Annoucements]     [IETF]     [IP Storage]     [Yosemite News]     [Linux SCTP]     [Linux Newbies]     [Mhonarc]     [Fedora Users]

  Powered by Linux