[Jmap] Review of draft-ietf-jmap-portability-extensions-00

Ken Murchison <murch@fastmail.com> Wed, 20 March 2024 04:23 UTC

Return-Path: <murch@fastmail.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 6128EC15108B for <jmap@ietfa.amsl.com>; Tue, 19 Mar 2024 21:23:17 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.805
X-Spam-Level:
X-Spam-Status: No, score=-2.805 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_ZEN_BLOCKED_OPENDNS=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01, URIBL_BLOCKED=0.001, URIBL_DBL_BLOCKED_OPENDNS=0.001, URIBL_ZEN_BLOCKED_OPENDNS=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=fastmail.com header.b="ki4jrtOc"; dkim=pass (2048-bit key) header.d=messagingengine.com header.b="ALajz2ri"
Received: from mail.ietf.org ([50.223.129.194]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id LPDAhqaEaieg for <jmap@ietfa.amsl.com>; Tue, 19 Mar 2024 21:23:12 -0700 (PDT)
Received: from wfout3-smtp.messagingengine.com (wfout3-smtp.messagingengine.com [64.147.123.146]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id EA39CC15107A for <jmap@ietf.org>; Tue, 19 Mar 2024 21:23:11 -0700 (PDT)
Received: from compute4.internal (compute4.nyi.internal [10.202.2.44]) by mailfout.west.internal (Postfix) with ESMTP id 5FF501C000A2 for <jmap@ietf.org>; Wed, 20 Mar 2024 00:23:11 -0400 (EDT)
Received: from mailfrontend1 ([10.202.2.162]) by compute4.internal (MEProxy); Wed, 20 Mar 2024 00:23:11 -0400
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=fastmail.com; h= cc:content-transfer-encoding:content-type:content-type:date:date :from:from:in-reply-to:message-id:mime-version:reply-to:subject :subject:to:to; s=fm2; t=1710908590; x=1710994990; bh=gA2TXItTCI xiJzbWLCBO0/DhLap2pl2QAg3xI6vlLQE=; b=ki4jrtOcNub3YnzPzUNZe80EXg bUsdNCvUSpENk7JHqsCjIPmBfUB4MLZCsMWt39PIsw3GJJwBLgo0LeHtRF5JmPcU 7jbdGUufhcP/plZIIowWP1sRAYXA1SvWbT9LRZOwvC9vIxQpBw7ErZPmDJWvpOhS bPxFGL3ktbz0x+IRtQN6M89rP1OuNO0A5SqZuvfpPZ8WNKvLo6CbSMt4W0sLKRzE 7qiq63gb1ptBbjzP99dEVvtfZWDT6JAuBO34wWqfAIAHvVNqDucYFjYPdfbYNbR0 ZSZLIxZIc8dMCy9qpN/0T/GKqng84SNyASM90n6pdb3QLWaWBqN1cO37o/MQ==
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-transfer-encoding:content-type :content-type:date:date:feedback-id:feedback-id:from:from :in-reply-to:message-id:mime-version:reply-to:subject:subject:to :to:x-me-proxy:x-me-proxy:x-me-sender:x-me-sender:x-sasl-enc; s= fm2; t=1710908590; x=1710994990; bh=gA2TXItTCIxiJzbWLCBO0/DhLap2 pl2QAg3xI6vlLQE=; b=ALajz2riI/L5M6QY44hiJ3FbmjP+REnrKRrtSLVgG/f6 hTAxGstzYwmVm0HR8MRqFdaLnm+CKWT+VC99qkpZG+PL4YmRr/hKrAoktShMDcC9 KDODDFCL90WQqrrVvh+6ePJw3qoMFoYaK6yaMA8H8GzhGgduMoZB020r+VcMHnmo Yxl6qwjQIJa2Mj6SY6BAGdUSQVXEQR4WloZi2wy8XQ57MRyBg7Yep3uYqaCau3u0 jwmxUxLliudKyPiOXSI0b8urNE+542bmnO5doPJaY1pe6sxH4zcRhdvt2y5Q9gb2 NY6s3HOMyG4PZxcXQlypjttKySLrKxrThMDt8awb2Q==
X-ME-Sender: <xms:rmT6ZcAqdPKvwshNL0fqU8a5Mz43mmJSdrqYFmLC0CX5Paz8vk5FhQ> <xme:rmT6ZejP1MryDxJ30iLG5aYSh2sZj-wEULJxSX5HjVh5Oo0eINXpzuam9ZN99pjpX U8ZeeerM_Qatw>
X-ME-Received: <xmr:rmT6ZflNp2CHuPNX8bgQmoI8zFxpMLS4hco4F3tF8fXqwrPydBUyust257N5LsSrzW_xJJR8qbeo1n_7Lqc1SvkuyljkqtQ>
X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvledrleefgdduiecutefuodetggdotefrodftvf curfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfghnecu uegrihhlohhuthemuceftddtnecunecujfgurhepkfffgggfvffhufhotgfgsehtkeertd dtvdejnecuhfhrohhmpefmvghnucfouhhrtghhihhsohhnuceomhhurhgthhesfhgrshht mhgrihhlrdgtohhmqeenucggtffrrghtthgvrhhnpeefveevgfegvdetvdekvdeuffetfe ettddvfeeijeegfeekleetveekvefhffdtffenucevlhhushhtvghrufhiiigvpedtnecu rfgrrhgrmhepmhgrihhlfhhrohhmpehmuhhrtghhsehfrghsthhmrghilhdrtghomh
X-ME-Proxy: <xmx:rmT6ZSxVuYvRy48QtN0QGbKudAwgDFKgkmp13vRjxGfsZIIwiYoimQ> <xmx:rmT6ZRSQQulzSUUSVDX61mGzOIXYr_qLIlmdQxdmJag9_SHqCS7UMw> <xmx:rmT6ZdbsH8qMJCKhyKCMe4BYJLpd12T5ZLLN8Y8-TYExg-5lfG6bOg> <xmx:rmT6ZaSsRRre4B_BcdKL5rploAo7faclsK1KJC4ks59M4cp4HPyMXw> <xmx:rmT6ZQJafd2Ekq1a--Y1y9Vw0JWksHnB_2SsgdLSR65sjzyCv96OQNdPMmU>
Feedback-ID: ibf914243:Fastmail
Received: by mail.messagingengine.com (Postfix) with ESMTPA for <jmap@ietf.org>; Wed, 20 Mar 2024 00:23:09 -0400 (EDT)
Message-ID: <f4a8f1dd-0764-4241-a982-baa84a8cb924@fastmail.com>
Date: Wed, 20 Mar 2024 00:23:07 -0400
MIME-Version: 1.0
User-Agent: Mozilla Thunderbird
To: jmap@ietf.org
Content-Language: en-US
From: Ken Murchison <murch@fastmail.com>
Organization: Fastmail US LLC
Content-Type: text/plain; charset="UTF-8"; format="flowed"
Content-Transfer-Encoding: 8bit
Archived-At: <https://mailarchive.ietf.org/arch/msg/jmap/wtLwW-kcrvuwsnM4QhRwcjD_JKI>
Subject: [Jmap] Review of draft-ietf-jmap-portability-extensions-00
X-BeenThere: jmap@ietf.org
X-Mailman-Version: 2.1.39
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: Wed, 20 Mar 2024 04:23:17 -0000

This doc looks fairly complete.  A few nits:

Section 1.2.1: The environment property is defined as being a String, 
but the example shows is as a SoftwareInfo object.

Section 1.2.1: As SoftwareInfo is also used for product, the definition 
of  the name property should probably just say something like "The name 
of the software" and not specify "JMAP API backend".

Section 1.2.2: I would think that the client would have to opt-in to 
receiving logs, but I don't see that in the text.  As a server 
developer, I don't want to take the time to generating these logs for a 
client that either doesn't want them and/or doesn't support them.

-- 
Kenneth Murchison
Senior Software Developer
Fastmail US LLC