[dnsext] editorials in draft-ietf-dnsext-dnssec-registry-update-01

Alfred Hönes <ah@TR-Sys.de> Tue, 27 March 2012 17:11 UTC

Return-Path: <dnsext-bounces@ietf.org>
X-Original-To: namedroppers-archive-gleetwall6@lists.ietf.org
Delivered-To: ietfarch-namedroppers-archive-gleetwall6@ietfa.amsl.com
Received: from ietfa.amsl.com (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id A56D921F873D; Tue, 27 Mar 2012 10:11:59 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ietf.org; s=ietf1; t=1332868319; bh=mGeTFvAy3M6SV+dMsT4bSXXxTQAwgA2grkfhnuzKA/I=; h=From:Message-Id:To:Date:Mime-Version:Cc:Subject:List-Id: List-Unsubscribe:List-Archive:List-Post:List-Help:List-Subscribe: Content-Type:Content-Transfer-Encoding:Sender; b=cErhebheqM0PFoOPWIZSVDCLJn1AvjbJ7EXmc3+kYC2xjXyaylm+Or0CsP+WJAHtu EVYXlxO4t/eQySxYSye+EC5FdGK9gcchT20J0qHz2K2rgPUX02YQfUZUb9H8RiEd0Q +dzGykphfPHHorKb3yRQ75JVjsEv6+8LWqSDeNT8=
X-Original-To: dnsext@ietfa.amsl.com
Delivered-To: dnsext@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 3D97E21F86F3 for <dnsext@ietfa.amsl.com>; Tue, 27 Mar 2012 10:11:58 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -98.636
X-Spam-Level:
X-Spam-Status: No, score=-98.636 tagged_above=-999 required=5 tests=[AWL=0.113, BAYES_00=-2.599, CHARSET_FARAWAY_HEADER=3.2, HELO_EQ_DE=0.35, MIME_8BIT_HEADER=0.3, USER_IN_WHITELIST=-100]
Received: from mail.ietf.org ([12.22.58.30]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id a9QwIvWzMRje for <dnsext@ietfa.amsl.com>; Tue, 27 Mar 2012 10:11:57 -0700 (PDT)
Received: from TR-Sys.de (gateway.tr-sys.de [213.178.172.147]) by ietfa.amsl.com (Postfix) with ESMTP id 8FE1F21F873A for <dnsext@ietf.org>; Tue, 27 Mar 2012 10:11:55 -0700 (PDT)
Received: from ZEUS.TR-Sys.de by w. with ESMTP ($Revision: 1.37.109.26 $/16.3.2) id AA271078246; Tue, 27 Mar 2012 19:10:46 +0200
Received: (from ah@localhost) by z.TR-Sys.de (8.9.3 (PHNE_25183)/8.7.3) id TAA05008; Tue, 27 Mar 2012 19:10:45 +0200 (MESZ)
From: Alfred Hönes <ah@TR-Sys.de>
Message-Id: <201203271710.TAA05008@TR-Sys.de>
To: scottr.nist@gmail.com
Date: Tue, 27 Mar 2012 19:10:44 +0200
X-Mailer: ELM [$Revision: 1.17.214.3 $]
Mime-Version: 1.0
Cc: dnsext@ietf.org
Subject: [dnsext] editorials in draft-ietf-dnsext-dnssec-registry-update-01
X-BeenThere: dnsext@ietf.org
X-Mailman-Version: 2.1.12
Precedence: list
List-Id: DNS Extensions working group discussion list <dnsext.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/dnsext>, <mailto:dnsext-request@ietf.org?subject=unsubscribe>
List-Archive: <http://www.ietf.org/mail-archive/web/dnsext>
List-Post: <mailto:dnsext@ietf.org>
List-Help: <mailto:dnsext-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/dnsext>, <mailto:dnsext-request@ietf.org?subject=subscribe>
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: 7bit
Sender: dnsext-bounces@ietf.org
Errors-To: dnsext-bounces@ietf.org

I observed a few editorial nits in
  draft-ietf-dnsext-dnssec-registry-update-01
that should be fixed before publication as an RFC.


(1)  Section 1

* 1st para:

Similarly as in the algo-signal I-D,
   "... digital signature algorithms (consisting of a cryptographic
    algorithm and one-way hash function)."
is an unfortunate verbiage.  My suggestion here is to insert
"public key-based " or  "asymmetrical " in front of
"cryptographic algorithm", to properly qualify the latter term.
In the last line, "a" should be added after "and" to balance the
language.

Further there is a singular/plural mismatch in the 2nd line:
"Extensions" (plural) <==> "uses" (singular)
Better:
   The DNS ... Extensions ... use digital signatures ...
                              ^^^

Finally I suggest to include the list of DNSSEC citations in the
parentheses in the 1st two lines and add the explanatory words
", defined by" before that list.

Altogether, after application of these suggestions, the 1st para
would look like:

|  The Domain Name System (DNS) Security Extensions (DNSSEC, defined by
|  [RFC4033], [RFC4034], [RFC4035], [RFC4509], [RFC5155], and [RFC5702])
   use digital signatures over DNS data to provide source authentication
   and integrity protection.  DNSSEC uses an IANA registry to list codes
|  for digital signature algorithms (consisting of an asymmetrical
   cryptographic algorithm and a one-way hash function).

* last para:

Typo:   s/auxillery/auxiliary/
               ^^        ^^

(2)  Section 2.1, last para

The preceding text does not reproduce the description values
currently found in the registry table.  Therefore, the beginning
of the 2nd para does not make much sense:

|  The above values are changed to "Reserved" because ...
             ^^^^^^
I suggest to replace "values" by "entries" or "assignments"
to achieve a proper logical connection to the preceding text.


(3)  Table in Section 2.2

* The 1st heading line of the table is misaligned relative to
  the 2nd heading line and the body of the table; it should be
  shifted to the left by two places.

* In the Description column for Algo # 1, please correct the typo:
  s/Depricated/Deprecated/
        ^          ^

Best regards,
  Alfred.

_______________________________________________
dnsext mailing list
dnsext@ietf.org
https://www.ietf.org/mailman/listinfo/dnsext