Last Call Review of draft-ietf-git-using-github-04
review-ietf-git-using-github-04-opsdir-lc-wu-2020-02-23-00
Request | Review of | draft-ietf-git-using-github |
---|---|---|
Requested revision | No specific revision (document currently at 06) | |
Type | Last Call Review | |
Team | Ops Directorate (opsdir) | |
Deadline | 2020-03-03 | |
Requested | 2020-02-18 | |
Authors | Martin Thomson , Barbara Stark | |
I-D last updated | 2020-02-23 | |
Completed reviews |
Opsdir Last Call review of -04
by Qin Wu
(diff)
Secdir Last Call review of -05 by Derek Atkins (diff) Genart Last Call review of -04 by Brian E. Carpenter (diff) Tsvart Last Call review of -04 by David L. Black (diff) Genart Telechat review of -05 by Brian E. Carpenter (diff) |
|
Assignment | Reviewer | Qin Wu |
State | Completed | |
Request | Last Call review on draft-ietf-git-using-github by Ops Directorate Assigned | |
Posted at | https://mailarchive.ietf.org/arch/msg/ops-dir/P-5JAGxQPrLKDfc4L0DCkBZP_uQ | |
Reviewed revision | 04 (document currently at 06) | |
Result | Has nits | |
Completed | 2020-02-23 |
review-ietf-git-using-github-04-opsdir-lc-wu-2020-02-23-00
I have reviewed this document as part of the Ops area directorate's ongoing effort to review all IETF documents being processed by the IESG. These comments were written primarily for the benefit of the Ops area directors. Document editors and WG chairs should treat these comments just like any other last call comments. Good work, this draft provides working group github usage guidance and document best practice that can be referenced by all IETF working groups. A few nits that need to be fixed before moving forward: 1. Section 5.2,3rd paragraph: The word "err" is a little bit weird to me. s/err more toward/lean more toward 2. Section 5.2 5th paragraph: "As mailing lists remain the primary venue for discussion of substantive matters, this mode and the document management only modes remain those most compatible with existing work practices for Working Groups." I feel the second half sentence is disconnected and not clear. should this be changed into "...only modes which remain those most" …? 3.Section 5.4.2,last paragraph The label “v2” has some ambiguity, since each draft may have already made multiple revisions. The latest version may not start with v1. In addition, should the decision label or component label be registered in IANA?