Re: [Gen-art] [kitten] Genart telechat review of draft-ietf-kitten-rfc5653bis-06

Benjamin Kaduk <kaduk@mit.edu> Wed, 07 February 2018 21:33 UTC

Return-Path: <kaduk@mit.edu>
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 4A59D12D87B; Wed, 7 Feb 2018 13:33:05 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -4.211
X-Spam-Level:
X-Spam-Status: No, score=-4.211 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, RCVD_IN_DNSWL_MED=-2.3, SPF_PASS=-0.001, T_RP_MATCHES_RCVD=-0.01] 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 OIpyitI13Had; Wed, 7 Feb 2018 13:33:03 -0800 (PST)
Received: from dmz-mailsec-scanner-6.mit.edu (dmz-mailsec-scanner-6.mit.edu [18.7.68.35]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 9DB3612D864; Wed, 7 Feb 2018 13:33:02 -0800 (PST)
X-AuditID: 12074423-e5dff70000000e05-5c-5a7b708beff5
Received: from mailhub-auth-2.mit.edu ( [18.7.62.36]) (using TLS with cipher DHE-RSA-AES256-SHA (256/256 bits)) (Client did not present a certificate) by dmz-mailsec-scanner-6.mit.edu (Symantec Messaging Gateway) with SMTP id 1F.7A.03589.C807B7A5; Wed, 7 Feb 2018 16:33:00 -0500 (EST)
Received: from outgoing.mit.edu (OUTGOING-AUTH-1.MIT.EDU [18.9.28.11]) by mailhub-auth-2.mit.edu (8.13.8/8.9.2) with ESMTP id w17LWrtv020105; Wed, 7 Feb 2018 16:32:55 -0500
Received: from mit.edu (24-107-191-124.dhcp.stls.mo.charter.com [24.107.191.124]) (authenticated bits=56) (User authenticated as kaduk@ATHENA.MIT.EDU) by outgoing.mit.edu (8.13.8/8.12.4) with ESMTP id w17LWn73025012 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Wed, 7 Feb 2018 16:32:51 -0500
Date: Wed, 07 Feb 2018 15:32:48 -0600
From: Benjamin Kaduk <kaduk@mit.edu>
To: Weijun Wang <weijun.wang@oracle.com>, Greg Hudson <ghudson@mit.edu>
Cc: draft-ietf-kitten-rfc5653bis.all@ietf.org, kitten <kitten@ietf.org>, gen-art <gen-art@ietf.org>, "Joel M. Halpern" <jmh@joelhalpern.com>, Alissa Cooper <alissa@cooperw.in>
Message-ID: <20180207213248.GB12363@mit.edu>
References: <074DA813-1E7F-4C03-AEEE-5D76E8804C31@oracle.com> <41bbbe7d-0f35-78ad-a5cd-673488f3ac09@joelhalpern.com> <20180103030817.GH50827@kduck.kaduk.org> <C47701B8-2504-490B-BE38-ED35A1D2C1A2@oracle.com> <19F5D23D-3677-41C6-B504-454C7595FF1F@cooperw.in> <D6DB69A6-5768-4536-89AA-40E0A905DF95@oracle.com> <366697b8-2a0c-243b-b153-ee8eb4358580@mit.edu> <8F5B79CD-B928-4B8E-97FA-D946784228B7@oracle.com> <505EACB9-D92E-4DE9-9ECC-DF931C1B924D@oracle.com> <20180207173534.GX12363@mit.edu>
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-Disposition: inline
In-Reply-To: <20180207173534.GX12363@mit.edu>
User-Agent: Mutt/1.9.1 (2017-09-22)
X-Brightmail-Tracker: H4sIAAAAAAAAA02Se0gTcQDH+d3dttvYxXkq+zUVYlp/rGZJUqPCLJQWPQgTokXU6U633G7j bj6mggY5apYFE9SZlmlYImQGMiuLRoaaPUASC0sihTYlE4uhkXXn8PHfFz7fB78HjlK1EjVu YZ0Mx9JWjVSBUbK0JN1VR5lxR3Bcq68b/gv0d/qfofoPoXlMPzc0g+j7H3Vg+t93u9B0qeHX ZBAxtLUtIIa3tWFgmJv6hJ3AjIp9JsZqKWK47WnnFeaX9xuAww1LZpviKsEA5QFyHJKp0N0z gXmAAqfIVgQuzrZKRECRXQAGw4YIGEZg00MfJgKMTILeJ5dkopYKurJ6BBV1DHkI1nZ2omIA JV8A2Dn+cbkpmjwD3S2jUlET5Db4ZzAsibQuoHCmNwgiIAoONkwuL6CkFo4tBREPwAUdB9uX cFHKSR0M3cwWHbFkIuyrCchuANK3LuxbF/athW8DtAMkmGylOhttsfJMro7PpVmW4XS7km0W ZzJjKuwGyxeekegHwZojAUDiQKMk6neXGSkJXcS7bAGwEUc0scS3llIjtSHHbnKZad58jiu0 MnwAQBzVxBCHjwp2wkS7ShnOvoLicEyjIgypW40UmU87mQKGcTDcCo3HcQ0klMIjU1Eck8+U 5FmszjWM4HKxXCmUP7WL5byDtvGW/AgfAjp87Pu0G6Uw1s4yahVxSjSRoslcyK72iJ8JFjwv DwGVcKxoYpEVXErhq602hYQRRBgZy3KJI056DakrgfzClejig8dDBR1+f3M4tMXwvrG5sbw3 Szk8i1tz/BNVyYqBN3VGc8WBn/dSljLoW909qotw73W9p20i01PXpz5b5d2U4J1O2e+tyPiC LLKVI58xt+zY1OPMKe2D7D2KanlF+84f9aer4rnRoneX1enX/p0snv/6Ku+1Kdu82aTBeDOd okU5nv4PZ19LzCcDAAA=
Archived-At: <https://mailarchive.ietf.org/arch/msg/gen-art/NjfFmH0fkS4ezHCE9FIK6QE5ODI>
Subject: Re: [Gen-art] [kitten] Genart telechat review of draft-ietf-kitten-rfc5653bis-06
X-BeenThere: gen-art@ietf.org
X-Mailman-Version: 2.1.22
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, 07 Feb 2018 21:33:05 -0000

And the rest of the review:

Line 2519, I think should --> SHOULD, since elsewhere we use SHOULD
for sending the error token to the peer.

Line 2561, I could go either way on "may" vs. "MAY" -- the argument
for the former would be that it's just stating an attribute of the
operation, and this text is describing something specified elsewhere
and not introducing any restrictions or giving guidance on it.
Similarly for acceptSecContext on line 2597.

Line 2668, SHOULD not --> SHOULD NOT

Line 2858, MAY --> may, since this is just describing what some
implementations could be doing and not exactly granting permission
for it.

I guess for consistency I should say the same thing about line 3049.

Line 3716, MUST not --> MUST NOT


In general, things looked quite good; I do not think I can say thank
you enough for putting this together.

Greg, would you be able to sanity-check the above (and one below)
comment?

Thanks,

Ben


On Wed, Feb 07, 2018 at 11:35:34AM -0600, Benjamin Kaduk wrote:
> I am doing a review now.  (Line 413, "SHOULD not" --> "SHOULD NOT"
> is all I have so far.)
> 
> And I will second Greg's comment about this format being an awesome
> way to view these changes -- thank you again for putting them
> together!
> 
> -Ben
> 
> On Tue, Feb 06, 2018 at 10:17:35PM +0800, Weijun Wang wrote:
> > I will submit a new draft tomorrow if there is no other feedback.
> > 
> > Thanks
> > Weijun
> > 
> > > On Jan 29, 2018, at 9:26 AM, Weijun Wang <weijun.wang@oracle.com> wrote:
> > > 
> > > The HTML file updated in place.
> > > 
> > > Thanks
> > > Weijun
> > > 
> > >> On Jan 27, 2018, at 10:12 AM, Greg Hudson <ghudson@mit.edu> wrote:
> > >> 
> > >> On 01/23/2018 06:43 PM, Weijun Wang wrote:
> > >>> I've uploaded an updated version at
> > >>> 
> > >>> http://cr.openjdk.java.net/~weijun/rfc5653bis/draft-ietf-kitten-rfc5653bis-07.html
> > >> 
> > >> This is a great format for reviewing these changes; thanks for
> > >> generating it.
> > >> 
> > >> Line 416 does not capitalize "optional" in "optional services", but
> > >> lines 385 and 391 do.
> > >> 
> > >> Lines 422 and 424 should probably capitalize "should".  Line 429 should
> > >> probably capitalize "may".
> > >> 
> > >> At line 598, I would lean towards leaving "MUST" in lowercase as we are
> > >> describing an application requirement, not prescribing one.
> > >> 
> > >> Line 1174, I would leave "MAY" in lowercase.
> > >> 
> > >> Line 1229, "may" should probably be capitalized.
> > >> 
> > >> Line 1369, I would leave "MAY" alone as this seems more descriptive than
> > >> prescriptive.
> > >> 
> > >> Line 3221's use of "SHOULD" is prescriptive, but there's no other way to
> > >> request the default QOP.  So I would leave it lowercase (or change the
> > >> wording, but I'm not trying to open any more cans of worms).
> > >> 
> > > 
> > > _______________________________________________
> > > Kitten mailing list
> > > Kitten@ietf.org
> > > https://www.ietf.org/mailman/listinfo/kitten
> >