[apps-discuss] Review of draft-ietf-appsawg-json-pointer

Paul Hoffman <paul.hoffman@vpnc.org> Thu, 15 November 2012 15:24 UTC

Return-Path: <paul.hoffman@vpnc.org>
X-Original-To: apps-discuss@ietfa.amsl.com
Delivered-To: apps-discuss@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 51CF621F8937 for <apps-discuss@ietfa.amsl.com>; Thu, 15 Nov 2012 07:24:24 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -102.541
X-Spam-Level:
X-Spam-Status: No, score=-102.541 tagged_above=-999 required=5 tests=[AWL=0.058, BAYES_00=-2.599, USER_IN_WHITELIST=-100]
Received: from mail.ietf.org ([64.170.98.30]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id dlVKqTa7UYAh for <apps-discuss@ietfa.amsl.com>; Thu, 15 Nov 2012 07:24:23 -0800 (PST)
Received: from hoffman.proper.com (IPv6.Hoffman.Proper.COM [IPv6:2605:8e00:100:41::81]) by ietfa.amsl.com (Postfix) with ESMTP id 9BA3621F8936 for <apps-discuss@ietf.org>; Thu, 15 Nov 2012 07:24:23 -0800 (PST)
Received: from [10.20.30.102] (50-0-66-243.dsl.dynamic.fusionbroadband.com [50.0.66.243]) (authenticated bits=0) by hoffman.proper.com (8.14.5/8.14.5) with ESMTP id qAFFOL0N064198 (version=TLSv1/SSLv3 cipher=AES128-SHA bits=128 verify=NO) for <apps-discuss@ietf.org>; Thu, 15 Nov 2012 08:24:22 -0700 (MST) (envelope-from paul.hoffman@vpnc.org)
From: Paul Hoffman <paul.hoffman@vpnc.org>
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: quoted-printable
Message-Id: <D8B6B887-7206-4197-B78D-7E2B38A20EF9@vpnc.org>
Date: Thu, 15 Nov 2012 07:24:28 -0800
To: "apps-discuss@ietf.org Discuss" <apps-discuss@ietf.org>
Mime-Version: 1.0 (Mac OS X Mail 6.2 \(1499\))
X-Mailer: Apple Mail (2.1499)
Subject: [apps-discuss] Review of draft-ietf-appsawg-json-pointer
X-BeenThere: apps-discuss@ietf.org
X-Mailman-Version: 2.1.12
Precedence: list
List-Id: General discussion of application-layer protocols <apps-discuss.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/apps-discuss>, <mailto:apps-discuss-request@ietf.org?subject=unsubscribe>
List-Archive: <http://www.ietf.org/mail-archive/web/apps-discuss>
List-Post: <mailto:apps-discuss@ietf.org>
List-Help: <mailto:apps-discuss-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/apps-discuss>, <mailto:apps-discuss-request@ietf.org?subject=subscribe>
X-List-Received-Date: Thu, 15 Nov 2012 15:24:24 -0000

This document mostly looks fine.

- I do not understand the use of "-"; at least one use of it in an application should be given.

- If "-" is useful, wouldn't it also be useful to have something that indicates the (non-existant) member before the first array element?

- Editorial nit in section 4:
      *  characters that represent an unsigned base-10 integer value
         (possibly with leading zeros), making the new referenced value
         is the array element with the zero-based index identified by
         the token, or
That should either be "the new referenced value is the" or "making the new referenced value the", I believe.

- One of the security considerations is too limited.
   Note that JSON pointers can contain the NUL (Unicode U+0000)
   character, which may not be representable in all programming
   languages.
The same is true for all control characters, and for some programming languages, all non-ASCII characters. Proposed rewording:
   Note that JSON pointers can contain the NUL (Unicode U+0000)
   character, control characters, non-ASCII characters, and so
   on. These characters may not be representable in all programming
   languages.

--Paul Hoffman