Re: [Cbor] πŸ”” WGLC on draft-ietf-cbor-array-tags-03

Jim Schaad <ietf@augustcellars.com> Sat, 09 March 2019 19:18 UTC

Return-Path: <ietf@augustcellars.com>
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 C5F9D124B91; Sat, 9 Mar 2019 11:18:18 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.901
X-Spam-Level:
X-Spam-Status: No, score=-1.901 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, RCVD_IN_DNSWL_NONE=-0.0001, SPF_PASS=-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 514m-lUx6n07; Sat, 9 Mar 2019 11:18:16 -0800 (PST)
Received: from mail2.augustcellars.com (augustcellars.com [50.45.239.150]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 5E70412426E; Sat, 9 Mar 2019 11:18:16 -0800 (PST)
Received: from Jude (192.168.1.152) by mail2.augustcellars.com (192.168.1.201) with Microsoft SMTP Server (TLS) id 15.0.1395.4; Sat, 9 Mar 2019 11:18:10 -0800
From: Jim Schaad <ietf@augustcellars.com>
To: cbor@ietf.org
CC: draft-ietf-cbor-array-tags@ietf.org
References: <426CD514-B174-4CE7-B467-2727C6B5B354@ericsson.com>
In-Reply-To: <426CD514-B174-4CE7-B467-2727C6B5B354@ericsson.com>
Date: Sat, 09 Mar 2019 11:18:06 -0800
Message-ID: <033701d4d6ac$d4b1fb60$7e15f220$@augustcellars.com>
MIME-Version: 1.0
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: quoted-printable
X-Mailer: Microsoft Outlook 16.0
Thread-Index: AQJDckXT1PNyaRbuIeGp9sN/08XZzKUlaSUA
Content-Language: en-us
X-Originating-IP: [192.168.1.152]
Archived-At: <https://mailarchive.ietf.org/arch/msg/cbor/EXykWYeA8LKbxZHJJuTPta84zaE>
Subject: Re: [Cbor] πŸ”” WGLC on draft-ietf-cbor-array-tags-03
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: Sat, 09 Mar 2019 19:18:19 -0000

Here is my WGLC review of the document.

1.  In section 2.1 I had a brief moment of frisson on the use of the term binary16 rather than float16 in Table 1.  There is no need to change it, I just was momentarily jolted.

2.  In section 2.1 - Slightly odd to say that ll is lsb as it is two bits long.  No need to change it, but the RSE may notice it.

3.  In section 2.1 - suggest s/Only the big endian variant is used./Only the big endian variant is assigned a tag./

4. In section 2.1 - There should be a note about the fate of the tags that would be <float, signed>.  Are they reserved or open for assignment.

5. In section 2.1 - After reading the last sentence, I am no longer sure what the fate of the 8-bit little endian tags are.  It would appear that they are being assigned from this paragraph.

6. In section 3 - It would make thing clearer if the description here noted that Homogeneous Arrays are one-dimensional array.

7. There should be a security consideration in terms of the Homogeneous type in terms of a naΓ―ve implementation.  The description contains the text "The element type  of the array is thus determined by the application type of the first array element"  Since it is not clear that this choosing of the application type does or does not still require that each element of the array be correctly type checked while reading the output is done, this requirement needs to be highlighted in the event that an element which does not following the homogeneous type follows.  Additionally, it might need to be noted that this does not imply that the same elements are going to be present in each element in the array.

Jim