Re: [Cbor] Iotdir early review of draft-ietf-cbor-network-addresses-05

Carsten Bormann <cabo@tzi.org> Mon, 26 July 2021 11:00 UTC

Return-Path: <cabo@tzi.org>
X-Original-To: cbor@ietfa.amsl.com
Delivered-To: cbor@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id F04043A0B1F; Mon, 26 Jul 2021 04:00:10 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.897
X-Spam-Level:
X-Spam-Status: No, score=-1.897 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] 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 hQO2oxx15N9D; Mon, 26 Jul 2021 04:00:06 -0700 (PDT)
Received: from gabriel-smtp.zfn.uni-bremen.de (mail.uni-bremen.de [134.102.50.15]) (using TLSv1.2 with cipher ADH-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id DA4593A0B1A; Mon, 26 Jul 2021 04:00:05 -0700 (PDT)
Received: from [192.168.217.118] (p548dcc89.dip0.t-ipconnect.de [84.141.204.137]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by gabriel-smtp.zfn.uni-bremen.de (Postfix) with ESMTPSA id 4GYH4z085jz2xMB; Mon, 26 Jul 2021 13:00:02 +0200 (CEST)
Content-Type: text/plain; charset="utf-8"
Mime-Version: 1.0 (Mac OS X Mail 13.4 \(3608.120.23.2.7\))
From: Carsten Bormann <cabo@tzi.org>
In-Reply-To: <162729343263.13734.5774247416866337222@ietfa.amsl.com>
Date: Mon, 26 Jul 2021 13:00:02 +0200
Cc: iot-directorate@ietf.org, cbor@ietf.org, draft-ietf-cbor-network-addresses.all@ietf.org
X-Mao-Original-Outgoing-Id: 648990002.68021-84d0cee00fe4fd418472c8ffe9f06122
Content-Transfer-Encoding: quoted-printable
Message-Id: <ECE0152F-121F-4EC4-94C3-EC7DB4A115D0@tzi.org>
References: <162729343263.13734.5774247416866337222@ietfa.amsl.com>
To: Mohit Sethi <mohit.m.sethi@ericsson.com>
X-Mailer: Apple Mail (2.3608.120.23.2.7)
Archived-At: <https://mailarchive.ietf.org/arch/msg/cbor/hwAE51qE5PjUytN5SFd2UQzWzeE>
Subject: Re: [Cbor] Iotdir early review of draft-ietf-cbor-network-addresses-05
X-BeenThere: cbor@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: "Concise Binary Object Representation \(CBOR\)" <cbor.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/cbor>, <mailto:cbor-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/cbor/>
List-Post: <mailto:cbor@ietf.org>
List-Help: <mailto:cbor-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/cbor>, <mailto:cbor-request@ietf.org?subject=subscribe>
X-List-Received-Date: Mon, 26 Jul 2021 11:00:11 -0000

Mohit,

thank you for the fast review!

On 2021-07-26, at 11:57, Mohit Sethi via Datatracker <noreply@ietf.org> wrote:
> 
> Reviewer: Mohit Sethi
> Review result: Ready with Issues
> 
> In the abstract, perhaps "describes" could be "specifies"/"defines"?

The introduction now says

   This document provides a format for IPv6 and IPv4 addresses,

Something similar might work for the abstract.

> It might make sense to provide references to the definition of tags 260  and
> 261. I had to look them up.

The reference should be through the registry, as the RFC will be immutable, and those links might change over time.
(Unfortunately, IANA doesn’t currently provide direct links into individual registrations, only references to entire tables:
https://www.iana.org/assignments/cbor-tags/cbor-tags.xhtml#table-tags
… which in this case are about as good as references to the entire registry:
https://www.iana.org/assignments/cbor-tags/cbor-tags.xhtml
)

> "was removed in this specification" -> "is removed in this specification"?

Well, “removed” is unclear relative to what anyway.
“Is not provided in…” maybe.

> "When applied to an array that starts with a number"? Is 'number' the correct
> terminology? I confused it with the tag number?

CBOR has different kinds of numbers, but here we really mean unsigned integer.

> What would happen to tags 260 and 261. Are they now discouraged/forbidden? Are
> they meant to co-exist with 52 and 54?

We don’t have a way to “deprecate” tags.

See also <https://mailarchive.ietf.org/arch/msg/cbor/6BqK5_jrqyz4JelJNbZ8Uwp3kV0>

So I’d like to keep this document free of such a relative grading.

Grüße, Carsten