Re: [calsify] [IANA #1156721] Early IANA Review for draft-ietf-calext-jscalendar-21

"Neil Jenkins" <neilj@fastmailteam.com> Thu, 05 December 2019 04:58 UTC

Return-Path: <neilj@fastmailteam.com>
X-Original-To: calsify@ietfa.amsl.com
Delivered-To: calsify@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 3972A120997 for <calsify@ietfa.amsl.com>; Wed, 4 Dec 2019 20:58:42 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.274
X-Spam-Level:
X-Spam-Status: No, score=-2.274 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, HTML_MESSAGE=0.001, PDS_BTC_ID=0.499, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H2=-0.073, SPF_PASS=-0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=fastmailteam.com header.b=T3prMJmk; dkim=pass (2048-bit key) header.d=messagingengine.com header.b=EshrDF4O
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 H1wPyNu9EXdY for <calsify@ietfa.amsl.com>; Wed, 4 Dec 2019 20:58:39 -0800 (PST)
Received: from out4-smtp.messagingengine.com (out4-smtp.messagingengine.com [66.111.4.28]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id A24F8120047 for <calsify@ietf.org>; Wed, 4 Dec 2019 20:58:39 -0800 (PST)
Received: from compute6.internal (compute6.nyi.internal [10.202.2.46]) by mailout.nyi.internal (Postfix) with ESMTP id B1491227A8; Wed, 4 Dec 2019 23:58:38 -0500 (EST)
Received: from imap99 ([10.202.2.99]) by compute6.internal (MEProxy); Wed, 04 Dec 2019 23:58:38 -0500
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= fastmailteam.com; h=mime-version:message-id:in-reply-to :references:date:from:to:cc:subject:content-type; s=fm1; bh=8oJv U9mcIo4H8FABVcX4lchc78mAP5BdG80q1BeYetA=; b=T3prMJmkDE1xEzWDsuQ5 NRe5eaE+rM+/W+yrd5Y+dU11iHpgkfLAAFjYhj8yzCtdGHIOiwjseWLudLsvoPXB vW7qTCCcZ27oM5Ts0Y1FaRPuvWK6TNySyw6/8LKrNntqsmG9kTcH3NaU3vIb67KS mAFVrbRmDTRNuI6WLEpK4fVOcm91sS1fhOtB1+isLgYWg51ArkZkqEJhj5UCfL+H Nrw9D+vTwJqIpu37rj2bLaNwldd68el5Qh5jLffan3D75mP5imPBXPof60TKVOXx axVBNfqxDK48/rS+eSCDhHw1jLov5QmJoK/PZDJOkHNfRJdM0x7Spk3F6l2TEj7Z Kw==
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-type:date:from:in-reply-to :message-id:mime-version:references:subject:to:x-me-proxy :x-me-proxy:x-me-sender:x-me-sender:x-sasl-enc; s=fm1; bh=8oJvU9 mcIo4H8FABVcX4lchc78mAP5BdG80q1BeYetA=; b=EshrDF4OeOplFUhBevyyck piQYPcBylngvm+C3bvvP9NT7xT91oV9BQEMAM1L2ebdpVW99yG4ayoQFPm6B9dWh Dfz6+dhLlWWXnaCcFQH41CFYFEy25KOKxYQz8acvmKq7uJafYZT9Vr5fb0XbuZqv TgIDnGomKM3/YeKg/vSv5z9aLhpJSe6GBRilrXplwcclIq7tRE/EGpeWIkjl5kjd AcNFrJ/3wb/yE5L2dE9hc5G6HnsmmEfH/TOGSszxR/kwsALBfENd59WCqnt4uJsW drTKIEOeP4HXxVu7h8EEhfYYonbBy9u2uVhjQrwNj7HFcMrIhp6I4H2a+K4ICdTg ==
X-ME-Sender: <xms:fo7oXZA1MZePFrfNcnireUIGQ3qh1tDh69iyIXpC9N7ALxF-953D9g>
X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedufedrudektddgjeeiucetufdoteggodetrfdotf fvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfqfgfvpdfurfetoffkrfgpnffqhgen uceurghilhhouhhtmecufedttdenucesvcftvggtihhpihgvnhhtshculddquddttddmne cujfgurhepofgfggfkjghffffhvffutgesrgdtreerreerjeenucfhrhhomhepfdfpvghi lhculfgvnhhkihhnshdfuceonhgvihhljhesfhgrshhtmhgrihhlthgvrghmrdgtohhmqe enucffohhmrghinhepihgvthhfrdhorhhgpdhirghnrgdrohhrghenucfrrghrrghmpehm rghilhhfrhhomhepnhgvihhljhesfhgrshhtmhgrihhlthgvrghmrdgtohhmnecuvehluh hsthgvrhfuihiivgeptd
X-ME-Proxy: <xmx:fo7oXZI1nOziXIsKhlt6kF0qwMS6yyUcLxsuIZfBYel-f7we35XUJA> <xmx:fo7oXYrg_XuNJ4qRc9ROm9c52ofaLxbXuzW7B3pAJ6DnAv7Hkgu6Rw> <xmx:fo7oXaM9HlQzpw4aD4_SmmNsG6KrUAFzRtjBvxN2DsoADTiJdkjZWw> <xmx:fo7oXbKfZK_scMTV7QbX6CuCR31I-YAEta66qf_rv4qMN918L0oZdw>
Received: by mailuser.nyi.internal (Postfix, from userid 501) id 3A66130006F; Wed, 4 Dec 2019 23:58:38 -0500 (EST)
X-Mailer: MessagingEngine.com Webmail Interface
User-Agent: Cyrus-JMAP/3.1.7-612-g13027cc-fmstable-20191203v1
Mime-Version: 1.0
Message-Id: <ee37001d-1c17-4fd6-9e10-1b12b4c87f08@dogfood.fastmail.com>
In-Reply-To: <DM6PR15MB353158A17E255B0BEB63143CE3470@DM6PR15MB3531.namprd15.prod.outlook.com>
References: <RT-Ticket-1156721@icann.org> <6E2BEA12-C0B7-4117-A263-AD6F71FD94AE@iana.org> <rt-4.4.3-31213-1574319687-1270.1156721-9-0@icann.org> <CH2PR15MB3525F1EE1F7939E5D71726D4E3490@CH2PR15MB3525.namprd15.prod.outlook.com> <rt-4.4.3-1085-1574389326-822.1156721-9-0@icann.org> <rt-4.4.3-32087-1574909133-1223.1156721-9-0@icann.org> <DM6PR15MB353158A17E255B0BEB63143CE3470@DM6PR15MB3531.namprd15.prod.outlook.com>
Date: Thu, 05 Dec 2019 15:58:18 +1100
From: Neil Jenkins <neilj@fastmailteam.com>
To: "iana-issues-comment@iana.org" <iana-issues-comment@iana.org>
Cc: Robert Stepanek <rsto@fastmailteam.com>, Daniel Migault <daniel.migault@ericsson.com>, "calsify@ietf.org" <calsify@ietf.org>
Content-Type: multipart/alternative; boundary="29d2d18fdcd54a00832f809e51f3223f"
Archived-At: <https://mailarchive.ietf.org/arch/msg/calsify/Mg2FfOVeqprzLCDm8G5Po1NckkE>
Subject: Re: [calsify] [IANA #1156721] Early IANA Review for draft-ietf-calext-jscalendar-21
X-BeenThere: calsify@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: <calsify.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/calsify>, <mailto:calsify-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/calsify/>
List-Post: <mailto:calsify@ietf.org>
List-Help: <mailto:calsify-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/calsify>, <mailto:calsify-request@ietf.org?subject=subscribe>
X-List-Received-Date: Thu, 05 Dec 2019 04:58:43 -0000

Sorry for the delay responding.

> About the statement that "The IANA will list common-use registrations prominently and separately from those with other intended use values": would listing common-use values first be sufficient, or would you want the registry divided into three separate registries? 

Listing common-use values first is fine, no need for separate registries.

> The registration procedure for common use registrations is described as Specification Required (it might be helpful to capitalize the registration procedures and cite RFC 8126), 

I will capitalise Specification Required. RFC 8126 is referenced in Section 8.2.3 describing the expert review, but I will add another reference here too.

> but in the template, the reference field is named "RFC Reference." On the other hand, if the statement in Section 8.2.3 that "for simple definitions a description in the registry may be sufficient" refers to the Specification Required range, I wonder if it could be more appropriate to describe the registration procedure for that range as Expert Review and have us add a note that says something like "RFC preferred." The registration procedures for all three ranges (common, reserved, obsolete) could be presented in a table like the ones at https://www.iana.org/assignments/cose, with the addition of a "Notes" field to expand on the requirements/expectations for common-use submissions.

I have changed this to "Reference or Description", defined as “A brief description or RFC number and section reference where the property is specified”.

While we could make it Expert Review, I think Specification Required is still correct, because we want to ensure there is sufficient documentation for interoperability. It's just sometimes a single sentence is sufficient, and to make it easy to update we'd like to just be able to put that straight in the registry rather than require a separate document.

Does that sound reasonable, or would you still prefer something different?

> The problem is that a description in the registry may not fit the description of Specification Required defined in Section 4.6 of RFC 8126:

Reading this again, I can't see anything in it that prohibits the specification being included in the registry entry itself.

> Sections 8.4.1 and 8.4.2 have the same title. 

This was a mistake; the second one should just be “JMAP Enum Subregistry Template”.

> Section 8.4 is unusual, as we haven't run into the idea of a template for a new subregistry.
> 
> We may have some presentation issues. We can't leave the subregistry name field blank, and it may not be possible to create additional fields at the top of the registry for Property Name, Property Context, and Change Controller, except within the context of a "Note:" field that appears after the registry reference. Even if the presentation in the document doesn't change, would it be possible to use a registry naming scheme that captures the property name and context, after which we could add the change controller information in a note? For example, would something like this work? 
> 
> Registry Name: Enum Values for freeBusyStatus Property (Contexts: JSEvent, JSTask)
> Reference: [this document]
> Registration Procedure: Expert Review
> Expert(s): [expert names]
> Note:
> Change Controller: IETF

I think this would be OK. I guess my main questions is can a new subregistry be added without an RFC (i.e. just by submitting to IANA the new subregistry template)? The scenario I'm thinking of is someone adds a new simple enumerable property and so needs a new subregistry.

> One more question: Section 8.4.1 says that the IETF is the change controller for Standards Track / BCP RFCs, but would the IETF not be the change controller for any IETF-stream RFC?

Yes, they probably should be. I've changed that.

I have published a new draft <https://tools.ietf.org/html/draft-ietf-calext-jscalendar-22> with the above changes for review.

Many thanks,
Neil.