Re: [Jmap] Murray Kucherawy's No Objection on draft-ietf-jmap-mdn-15: (with COMMENT)

Barry Leiba <barryleiba@computer.org> Tue, 29 September 2020 16:19 UTC

Return-Path: <barryleiba@gmail.com>
X-Original-To: jmap@ietfa.amsl.com
Delivered-To: jmap@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id F15C13A0F03; Tue, 29 Sep 2020 09:19:24 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.65
X-Spam-Level:
X-Spam-Status: No, score=-1.65 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, FREEMAIL_FORGED_FROMDOMAIN=0.001, FREEMAIL_FROM=0.001, HEADER_FROM_DIFFERENT_DOMAINS=0.249, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001] autolearn=no 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 SczXIv8XyCMq; Tue, 29 Sep 2020 09:19:24 -0700 (PDT)
Received: from mail-ej1-f47.google.com (mail-ej1-f47.google.com [209.85.218.47]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 76C853A11E2; Tue, 29 Sep 2020 09:17:44 -0700 (PDT)
Received: by mail-ej1-f47.google.com with SMTP id i26so15827091ejb.12; Tue, 29 Sep 2020 09:17:44 -0700 (PDT)
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=yBUb+UvyTiR1rOtrn41yj0yOAl78GgNOvGliGEXJOSc=; b=Ln4M26qxIL52MjX/imdQ+J/wpyBgr5SlkXHoZK7klVIKuizW/HtdwFsarOYo1YiOkR wgVedS99baNcMfEdYLjGlUoWmIH9d3aEg5ef/VluxEWO5KxSfAvqCfGrjfGES0wQ9Fc/ xZVDhFSQMzXfh2uCvX1OpSZuifrHYeiIpi8F+6xpFQ5uLdmZ1Y8fd2+HXuIrOk2DfSPs jdYBIfpjSnTPwVjIgUB2DSYb3yg0Q7gB7VlxMhdSdPiuXLW2HgskCEIpMEve9nQPX4db WXXvGbwF6tqb+ndnsC5qghSvTL7zbwojSkIwWzIE+6Fgl1J0Ld7vcWsj2KtVeLo8DaHb ZCHg==
X-Gm-Message-State: AOAM531jN3xrCNWlQYCnrsS/63yos/Wtt9VFyS+u2ju4FclNC3hRHD03 68600igefnzbNS2u16zdWyudWUmG5pviFQihn40pZXwy4olVcw==
X-Google-Smtp-Source: ABdhPJyHpt+Ki+A0C7QgBSL1SJuziQtzptfcBctHPtSUP2mKGKjAtGJHU7NwBsAgrc6ee+ECTYswLvvZkTH49nLvUbI=
X-Received: by 2002:a17:906:d97b:: with SMTP id rp27mr4878434ejb.18.1601396262696; Tue, 29 Sep 2020 09:17:42 -0700 (PDT)
MIME-Version: 1.0
References: <160139528034.2924.9672441697416964848@ietfa.amsl.com>
In-Reply-To: <160139528034.2924.9672441697416964848@ietfa.amsl.com>
From: Barry Leiba <barryleiba@computer.org>
Date: Tue, 29 Sep 2020 12:17:30 -0400
Message-ID: <CALaySJKWgBaZnYXk9TrZTCWXjeQHc=duaqPPf_avG1X504-LFQ@mail.gmail.com>
To: Murray Kucherawy <superuser@gmail.com>
Cc: The IESG <iesg@ietf.org>, IETF JMAP Mailing List <jmap@ietf.org>, Bron Gondwana <brong@fastmailteam.com>, draft-ietf-jmap-mdn@ietf.org, jmap-chairs@ietf.org
Content-Type: text/plain; charset="UTF-8"
Archived-At: <https://mailarchive.ietf.org/arch/msg/jmap/Akx9OkuloQSMIzFEJMTuGYbB3RQ>
Subject: Re: [Jmap] Murray Kucherawy's No Objection on draft-ietf-jmap-mdn-15: (with COMMENT)
X-BeenThere: jmap@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: JSON Message Access Protocol <jmap.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/jmap>, <mailto:jmap-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/jmap/>
List-Post: <mailto:jmap@ietf.org>
List-Help: <mailto:jmap-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/jmap>, <mailto:jmap-request@ietf.org?subject=subscribe>
X-List-Received-Date: Tue, 29 Sep 2020 16:19:25 -0000

Coupla comments:

> There are several places in the document where "header" should be changed to
> "header field".

> b) There's an extension in Section 3.1 starting with "X-" that should probably
> be revisited given BCP 178.

Yes, indeed, and I'm sorry I missed these in my review.  Flrg.

> This is totally a personal nit, and you're free to ignore me, but since I keep
> tripping on it I'll mention it: In various places, "id" is used as a word
> rather than an initialism, as in "The id of the account to use."  I keep
> reading this as the English term from psychoanalysis rather than a truncation
> of "identifier".  I'd probably be happier if the full word was used.

I agree that we should simply spell out "identifier", and I strongly
encourage that change.

> a) s/guaranty/guarantee/ (multiple instances)

How US-centric of you, Murray!

Barry