Last Call Review of draft-ietf-opsawg-pcaplinktype-05
review-ietf-opsawg-pcaplinktype-05-intdir-lc-bernardos-2024-08-22-00
Request | Review of | draft-ietf-opsawg-pcaplinktype |
---|---|---|
Requested revision | No specific revision (document currently at 08) | |
Type | Last Call Review | |
Team | Internet Area Directorate (intdir) | |
Deadline | 2024-08-26 | |
Requested | 2024-08-12 | |
Requested by | Joe Clarke | |
Authors | Guy Harris , Michael Richardson | |
I-D last updated | 2024-08-22 | |
Completed reviews |
Genart Last Call review of -04
by Joel M. Halpern
(diff)
Intdir Last Call review of -05 by Carlos J. Bernardos (diff) |
|
Assignment | Reviewer | Carlos J. Bernardos |
State | Completed | |
Request | Last Call review on draft-ietf-opsawg-pcaplinktype by Internet Area Directorate Assigned | |
Posted at | https://mailarchive.ietf.org/arch/msg/int-dir/Y_V1GCEOIusCsXwzOHKXyIKf_1w | |
Reviewed revision | 05 (document currently at 08) | |
Result | Ready w/nits | |
Completed | 2024-08-22 |
review-ietf-opsawg-pcaplinktype-05-intdir-lc-bernardos-2024-08-22-00
I am an assigned INT directorate reviewer for draft-ietf-opsawg-pcaplinktype. These comments were written primarily for the benefit of the Internet Area Directors. Document editors and shepherd(s) should treat these comments just like they would treat comments from any other IETF contributors and resolve them along with any other Last Call comments that have been received. For more details on the INT Directorate, see https://datatracker.ietf.org/group/intdir/about/ <https://datatracker.ietf.org/group/intdir/about/>. I think the document is almost ready. I’ve just found a few nits. The following are minor issues (typos, misspelling, minor text improvements) with the document: - “Wireshark” and “wireshark” is used in the document. Please choose one capitalization and be consistent throughout the document. - “ Reference: Indicates an authoritative the document reference for the LinkType or a requester reference.” —> this sentence does not parse well. I guess the “the” between “authoritative” and “document” should be removed. - “DLT” should be expanded. - “ maintain URLs over a long period of time, and a documented in a "wp-uploaded" section is highly likely to disappear.” —> does not parse well. I guess “a” in “a document” should be removed. - “ In addition Specifications that require a reader to click ” —> I think a comma is missing after “addition”. - “(This is the opinion of other corporate lawyers, who worry about what their employees might have agreed to)” —> is this really needed? - “Linktypes may be allocated for specifications not publically available may be made within the First-Come/First-Served area. This includes specifications that might be classified. The minimal requirement is for a contact person for that link type.” —> I think this needs to be rewritten. - “Linktypes” and LINKTYPE” are used sometimes with the same meaning (I guess).