Re: [Extra] AD Review of draft-ietf-extra-imap4rev2

Alexey Melnikov <alexey.melnikov@isode.com> Mon, 04 January 2021 15:39 UTC

Return-Path: <alexey.melnikov@isode.com>
X-Original-To: extra@ietfa.amsl.com
Delivered-To: extra@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 643B53A0E0A for <extra@ietfa.amsl.com>; Mon, 4 Jan 2021 07:39:13 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -0.459
X-Spam-Level:
X-Spam-Status: No, score=-0.459 tagged_above=-999 required=5 tests=[DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, HTML_MESSAGE=0.001, NICE_REPLY_A=-0.262, RCVD_IN_DNSWL_BLOCKED=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=isode.com
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 58TsIPuMkFRR for <extra@ietfa.amsl.com>; Mon, 4 Jan 2021 07:39:12 -0800 (PST)
Received: from statler.isode.com (Statler.isode.com [62.232.206.189]) by ietfa.amsl.com (Postfix) with ESMTP id 1C4773A0E07 for <extra@ietf.org>; Mon, 4 Jan 2021 07:39:12 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; t=1609774746; d=isode.com; s=june2016; i=@isode.com; bh=OuT3k9Qf85Pc8P3jI+uud0/wCme0LbFBcq6mnADLO80=; h=From:Sender:Reply-To:Subject:Date:Message-ID:To:Cc:MIME-Version: In-Reply-To:References:Content-Type:Content-Transfer-Encoding: Content-ID:Content-Description; b=t3iH/3LbIdw2fpavRwMYPDE9o5aTo4diB4NhGXsroU8mMiBDJ+z9h0FYuxOjzbrhCbBwa8 o5XcrDh/uylE6o/trhEzaPkdWYxH8jxAVA1bcS5eSOE9PO8E/J2i0//m/Zt1e41gMS5Dma l29qlQO4l8bnys9So9o88YNVyLfDze4=;
Received: from [172.27.255.49] (connect.isode.net [172.20.0.72]) by statler.isode.com (submission channel) via TCP with ESMTPSA id <X=M2mQBqmqay@statler.isode.com>; Mon, 4 Jan 2021 15:39:05 +0000
From: Alexey Melnikov <alexey.melnikov@isode.com>
To: "Murray S. Kucherawy" <superuser@gmail.com>, extra@ietf.org
References: <CAL0qLwaLa+PuGWRrKTbpmDa_SWKT9ZQUEQ9dsPgXfUmTzcYAYw@mail.gmail.com>
Message-ID: <ae15071e-3ab5-2ad0-953b-05856991b287@isode.com>
Date: Mon, 4 Jan 2021 15:39:05 +0000
User-Agent: Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:78.0) Gecko/20100101 Thunderbird/78.5.0
In-Reply-To: <CAL0qLwaLa+PuGWRrKTbpmDa_SWKT9ZQUEQ9dsPgXfUmTzcYAYw@mail.gmail.com>
MIME-Version: 1.0
Content-Type: multipart/alternative; boundary="------------94E21C5BA11781724E9EC24A"
Content-Language: en-GB
Archived-At: <https://mailarchive.ietf.org/arch/msg/extra/4hvAdNszEeLrg6VArFHOk44wIWA>
Subject: Re: [Extra] AD Review of draft-ietf-extra-imap4rev2
X-BeenThere: extra@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: Email mailstore and eXtensions To Revise or Amend <extra.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/extra>, <mailto:extra-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/extra/>
List-Post: <mailto:extra@ietf.org>
List-Help: <mailto:extra-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/extra>, <mailto:extra-request@ietf.org?subject=subscribe>
X-List-Received-Date: Mon, 04 Jan 2021 15:39:13 -0000

Hi Murray,

Replying to some remaining editorial comments:

On 04/01/2021 08:18, Murray S. Kucherawy wrote:
>
> Section 5.1
>
>
> There’s a reference “see the Formal Syntax” which could probably 
> benefit from a section number reference as well.  This is actually 
> something I’d thought about many times earlier in the document up to 
> this point, but I’m finally saying something here; some of them were 
> clear references like this, while others were references to commands 
> or flags that are “described elsewhere in this document”.
>
I fixed several cases of missing references. If you find anything else I 
missed, please let me know.

> Section 6.4.4.4
>
>
> I think the inline comments in the various examples don’t really need 
> to be inline.  They could just as easily be prose below each example.
>
For some examples this might be more involved than for others. Are you 
happy for this to be addressed directly with RFC Editor via an XML comment?

> Section 7.2 and its subsections
>
>
> A fair bit of this text is repeated verbatim from earlier sections and 
> should probably be consolidated.  I really noticed this when I hit 
> Section 7.2.3 where, for instance, \HasChildren is defined both here 
> and in Section 6.3.9.5, with the paragraphs in both sections being 
> identical. However, now that I look earlier in 7.2.2, I see the same 
> issue.
>
I struggled with some of this, as initially not all mailbox attributes 
were listed in Section 7.2.3 (LIST Response). In other sections it is 
had to talk about some options without introducing the corresponding 
mailbox attribute(s) first. So it would really help to have some 
specific suggestions on where you think text can be dropped.

Best Regards,

Alexey