[Gen-art] review of draft-holmberg-dispatch-received-realm-08.txt

Francis Dupont <Francis.Dupont@fdupont.fr> Wed, 09 November 2016 14:52 UTC

Return-Path: <Francis.Dupont@fdupont.fr>
X-Original-To: gen-art@ietfa.amsl.com
Delivered-To: gen-art@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 8E2A11299DF; Wed, 9 Nov 2016 06:52:00 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -3.399
X-Spam-Level:
X-Spam-Status: No, score=-3.399 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, RP_MATCHES_RCVD=-1.497, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001] autolearn=ham autolearn_force=no
Received: from mail.ietf.org ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id qwW26t2PWlyT; Wed, 9 Nov 2016 06:51:59 -0800 (PST)
Received: from givry.fdupont.fr (givry.fdupont.fr [IPv6:2001:41d0:1:6d55:211:5bff:fe98:d51e]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id A805E12997A; Wed, 9 Nov 2016 06:51:58 -0800 (PST)
Received: from givry.fdupont.fr (localhost [IPv6:::1]) by givry.fdupont.fr (8.14.7/8.14.7) with ESMTP id uA9EjqLl097102; Wed, 9 Nov 2016 15:45:53 +0100 (CET) (envelope-from dupont@givry.fdupont.fr)
Message-Id: <201611091445.uA9EjqLl097102@givry.fdupont.fr>
From: Francis Dupont <Francis.Dupont@fdupont.fr>
To: gen-art@ietf.org
Date: Wed, 09 Nov 2016 15:45:52 +0100
Archived-At: <https://mailarchive.ietf.org/arch/msg/gen-art/kQqvg61iSwXqk7BbXFZxrY1Rdc8>
Cc: draft-holmberg-dispatch-received-realm.all@ietf.org
Subject: [Gen-art] review of draft-holmberg-dispatch-received-realm-08.txt
X-BeenThere: gen-art@ietf.org
X-Mailman-Version: 2.1.17
Precedence: list
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: Wed, 09 Nov 2016 14:52:00 -0000

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 treat these comments just
like any other last call comments.

For more information, please see the FAQ at

<http://wiki.tools.ietf.org/area/gen/trac/wiki/GenArtfaq>.

Document: draft-holmberg-dispatch-received-realm-08.txt
Reviewer: Francis Dupont
Review Date: 20161103
IETF LC End Date: 20161123
IESG Telechat date: unknown

Summary: Almost Ready

Major issues: None

Minor issues: the wording should be improved by a native English writer
(there are no language construct I can't understand but some are clearly
incorrect and I am not sure someone for instance from Asia will have
no trouble).

Nits/editorial comments:
 - title page 1: Add SIP before "Via header"

 - ToC page 2 and 10 page 11: Acknowledgements -> Acknowledgments

 - 1.1 page 2: IMHO it is better to expand the SIP abbrev as it is done
  in the Abstract (note SIP is well known so it is not required to expand
  it at the first use).

 - 1.1 page 2: the SIP requests -> SIP requests

 - 1.1 page 2: transit network. -> transit networks.

 - 1.1 page 3 (wording): In order to do that ... , belongs.
  This construct is not natural at all in English

 - 1.2 page 3: e.g. -> , e.g., (and) (e.g. -> (e.g.,

 - 1.3 page 4 (at end of line): i.e. -> i.e.,

 - 2 page 4: perhaps there should be an extra comma in "based e.g., on..."?
  (I suggest to use "for instance")

 - 3 page 4: you don't list all RFC 2119 key words (I am not sure
  it is a problem but for instance MAY NOT is not there).

 - 5.3 page 5: proceudres -> procedures

 - 5.6.2 page 8: the received-realm rule is not indented as others

 - 6.2 page 8 and 6.3 page 9: (e.g. -> (e.g., 

Regards

Francis.Dupont@fdupont.fr