[Gen-art] Genart telechat review of draft-ietf-dnsop-algorithm-update-07

Peter Yee via Datatracker <noreply@ietf.org> Sat, 06 April 2019 09:16 UTC

Return-Path: <noreply@ietf.org>
X-Original-To: gen-art@ietf.org
Delivered-To: gen-art@ietfa.amsl.com
Received: from ietfa.amsl.com (localhost [IPv6:::1]) by ietfa.amsl.com (Postfix) with ESMTP id 8727E120314; Sat, 6 Apr 2019 02:16:26 -0700 (PDT)
MIME-Version: 1.0
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: 7bit
From: Peter Yee via Datatracker <noreply@ietf.org>
To: gen-art@ietf.org
Cc: draft-ietf-dnsop-algorithm-update.all@ietf.org, dnsop@ietf.org, ietf@ietf.org
X-Test-IDTracker: no
X-IETF-IDTracker: 6.94.1
Auto-Submitted: auto-generated
Precedence: bulk
Reply-To: Peter Yee <peter@akayla.com>
Message-ID: <155454218650.21891.1515975582177931040@ietfa.amsl.com>
Date: Sat, 06 Apr 2019 02:16:26 -0700
Archived-At: <https://mailarchive.ietf.org/arch/msg/gen-art/7SKWsZl8fTijm8PvYkoIShnQOKo>
Subject: [Gen-art] Genart telechat review of draft-ietf-dnsop-algorithm-update-07
X-BeenThere: gen-art@ietf.org
X-Mailman-Version: 2.1.29
List-Id: "GEN-ART: General Area Review Team" <gen-art.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/gen-art>, <mailto:gen-art-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/gen-art/>
List-Post: <mailto:gen-art@ietf.org>
List-Help: <mailto:gen-art-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/gen-art>, <mailto:gen-art-request@ietf.org?subject=subscribe>
X-List-Received-Date: Sat, 06 Apr 2019 09:16:26 -0000

Reviewer: Peter Yee
Review result: Ready with Nits

I am the assigned Gen-ART reviewer for this draft. The General Area
Review Team (Gen-ART) reviews all IETF documents being processed
by the IESG for the IETF Chair. Please wait for direction from your
document shepherd or AD before posting a new version of the draft.

For more information, please see the FAQ at

<https://trac.ietf.org/trac/gen/wiki/GenArtfaq>.

Document: draft-ietf-dnsop-algorithm-update-07
Reviewer: Peter Yee
Review Date: 2019-04-06
IETF LC End Date: 2019-02-27
IESG Telechat date: 2019-04-11

Summary:  This document updates the DNSKEY, DS, and CDS algorithm
recommendations for use in DNSSEC based on current thinking in cryptography. 
This document is Ready with Nits as a Standards Track publication.

Major issues: None

Minor issues: None

Nits/editorial comments:

Page 2, Section 1.1, 2nd sentence: append a comma after "New".

Page 3, Section 1.2, 2nd paragraph, 1st sentence: change "recommendation cannot
be recommended" to "they cannot be recommended".

Page 3, Section 1.2, 4th paragraph, 2nd sentence: change "recommendation" to
"intent".

Page 3, Section 1.2, 6th paragraph, 1st sentence: change "DNSKEY's" to
"DNSKEYs".

Page 3, Section 1.2, 6th paragraph, 3rd sentence: indicate for clarity where
this marking will be done (essentially in a new version of this RFC).

Page 4, Section 1.3: In general, it would be nice if there were references in
the paragraphs following the table that point to the research that led to the
statements of strength or lack of strength of the algorithms.  Then again, this
isn't an academic paper, so references aren't strictly required either.  While
I mostly (but not completely) agree with the notes on the individual
algorithms, the average reader is left to take the statements as gospel rather
than being able to make an informed decision on the current state of
cryptography.

Page 4, Section 1.3, 3rd sentence: delete a redundant "from".

Page 5, 4th paragraph, 2nd sentence: change "cryptographics" to "cryptographic".

Page 5, 4th paragraph, 3rd sentence: change "that" to "who".

Page 5, 5th paragraph, 2nd sentence: delete "The" before "GOST".  I'm generally
in favor of dropping the definite article of algorithm abbreviations.  If you
prefer not to do so, then use the definitive article consistently throughout
the document.

Page 5, 6th paragraph, 3rd sentence: insert "the" before "deterministic".

Page 5, 8th paragraph, 1st sentence: change "ED25519" to "Ed25519".  Change
"ED448" to "Ed448".  Only make these two changes if you are referring to these
algorithms by the names given to them by their authors as opposed to the
mnemonics used within DNSSEC.  (This statement also applies to the Ed25519
comment below.) Insert "the" before "Edwards".

Page 5, 8th paragraph, 2nd sentence: delete "the" before "EdDSA".  Delete
"algorithm" after "EdDSA".

Page 5, 8th paragraph, 4th sentence: change "ED25519" to "Ed25519".

Page 6, Section 3.2, 2nd paragraph: insert "the" before "industry".  Change "to
move to" to "toward".  Delete "the" before "ECDSAP256SHA256 ".  Insert "the"
before "RECOMMENDED".  Change "RSA based" to "RSA-based".

Page 6, Section 3.3, 3rd paragraph, 1st fragment: change "for" to "regarding". 
Append "are summarized in the table below." to the fragment.

Page 6, Section 3.3, 3rd paragraph, 2nd sentence: append "recommendations"
after "These".

Page 6, 1st paragraph after table: append a period to the end of the sentence.

Page 6, 2nd paragraph after the table: append a period to the end of the
sentence.

Page 6, 4th paragraph after the table, 2nd sentence: delete "The" before "GOST".

Page 6, 5th paragraph, 1st sentence: change second "SHA-384" to "SHA-256".

Page 7, Section 3.4, 1st sentence: change the period at the end of a sentence
to a colon.  Join the following sentence to the first sentence after deleting
"The" before "SHA-256" and insert "the" before "RECOMMENDED".

Page 7, Section 4: this section has not been reviewed since it is to be deleted
by the RFC Editor prior to publication.

Page 8, Section 5, 2nd paragraph, 2nd sentence: consider appending "(in the
cryptographic sense)" after "broken".

Page 9, Section 8, 1st paragraph, 1st sentence: delete an extraneous space
after "I.".  Append a comma after "Wouters".

Page 9, Section 8, 2nd paragraph: append a comma after "Hoffman".  "Imminent"
in this sentence is probably not the word you want in document at time of
publication, although it's fine to prod the named individuals into submitted
input prior to publication.

Page 9, Section 8, 3rd paragraph: change "the daylight" to "light".