Re: [Json] Gen-ART and OPS-Dir review of draft-ietf-json-text-sequence-10
Nico Williams <nico@cryptonector.com> Thu, 11 December 2014 22:46 UTC
Return-Path: <nico@cryptonector.com>
X-Original-To: ietf@ietfa.amsl.com
Delivered-To: ietf@ietfa.amsl.com
Received: from localhost (ietfa.amsl.com [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 0930D1A8A4C; Thu, 11 Dec 2014 14:46:53 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.666
X-Spam-Level:
X-Spam-Status: No, score=-1.666 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, IP_NOT_FRIENDLY=0.334, RCVD_IN_DNSWL_NONE=-0.0001] autolearn=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 cZ-guEOTTqm2; Thu, 11 Dec 2014 14:46:52 -0800 (PST)
Received: from homiemail-a113.g.dreamhost.com (sub4.mail.dreamhost.com [69.163.253.135]) by ietfa.amsl.com (Postfix) with ESMTP id 23C061A8A42; Thu, 11 Dec 2014 14:46:52 -0800 (PST)
Received: from homiemail-a113.g.dreamhost.com (localhost [127.0.0.1]) by homiemail-a113.g.dreamhost.com (Postfix) with ESMTP id DF18120058D87; Thu, 11 Dec 2014 14:46:51 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha1; c=relaxed; d=cryptonector.com; h=date :from:to:cc:subject:message-id:references:mime-version :content-type:in-reply-to; s=cryptonector.com; bh=cmtOL8YDvgP0jx CQqDKgbitJJcQ=; b=RjV+M+LgM4H0PEhdzya/ErwfycRRsd1YCtgy4C81dsQbDm Bm6zwnm6tFGtsEMFdG5O3g5n4+RaniJiTCxUWOeXMekfVcvHxrYhKc38AHTLHRLw OfgWF44JJ6i53SBSeqApPOdHZIadH3UzPeEZYYux4TjL1yE2k5d5yNaHWdWXE=
Received: from localhost (108-207-244-174.lightspeed.austtx.sbcglobal.net [108.207.244.174]) (Authenticated sender: nico@cryptonector.com) by homiemail-a113.g.dreamhost.com (Postfix) with ESMTPA id 5C13420058D85; Thu, 11 Dec 2014 14:46:51 -0800 (PST)
Date: Thu, 11 Dec 2014 16:46:50 -0600
From: Nico Williams <nico@cryptonector.com>
To: Paul Hoffman <paul.hoffman@vpnc.org>
Subject: Re: [Json] Gen-ART and OPS-Dir review of draft-ietf-json-text-sequence-10
Message-ID: <20141211224646.GJ3448@localhost>
References: <CE03DB3D7B45C245BCA0D243277949362B18C7@MX104CL02.corp.emc.com> <475F8F1D-6F6A-47E3-AE60-7BDC7AB6BD66@vpnc.org>
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-Disposition: inline
In-Reply-To: <475F8F1D-6F6A-47E3-AE60-7BDC7AB6BD66@vpnc.org>
User-Agent: Mutt/1.5.21 (2010-09-15)
Archived-At: http://mailarchive.ietf.org/arch/msg/ietf/vovx15CQ4GzZhHHnAmoK73p38DA
Cc: "Black, David" <david.black@emc.com>, "json@ietf.org" <json@ietf.org>, "ops-dir@ietf.org" <ops-dir@ietf.org>, "General Area Review Team (gen-art@ietf.org)" <gen-art@ietf.org>, "ietf@ietf.org" <ietf@ietf.org>
X-BeenThere: ietf@ietf.org
X-Mailman-Version: 2.1.15
Precedence: list
List-Id: IETF-Discussion <ietf.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/ietf>, <mailto:ietf-request@ietf.org?subject=unsubscribe>
List-Archive: <http://www.ietf.org/mail-archive/web/ietf/>
List-Post: <mailto:ietf@ietf.org>
List-Help: <mailto:ietf-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/ietf>, <mailto:ietf-request@ietf.org?subject=subscribe>
X-List-Received-Date: Thu, 11 Dec 2014 22:46:53 -0000
On Thu, Dec 11, 2014 at 10:29:16AM -0800, Paul Hoffman wrote: > <shepherd hat on> > > Item [F] about the <angle-bracketed> text in the IANA Considerations > > (Section 4) remains open - if the intent is to not deal with replacing > > that text until after IESG approval, an RFC Editor Note to that effect > > should be added to Section 4. > > David: I disagree with the need for this change. The RFC Editor can > interpret the current wording just fine. I'll leave them as-is then. > > I have an additional editorial concern - given all the discussion about > > UTF-8, it would be good for the draft to make it clear early on > > that JSON text sequences are UTF-8 only. Here are some suggested changes. > > > > Abstract: > > > > This document describes the JSON text sequence format and associated > > media type, "application/json-seq". A JSON text sequence consists of > > any number of JSON texts, each prefix by an Record Separator > > (U+001E), and each ending with a newline character (U+000A). > > > > "any number of JSON texts" -> "any number of UTF-8 encoded JSON texts" > > This change concerns me, because it sounds like a JSON text sequence > could consist of JSON texts encoded in UTF-8 and other encodings. I > would instead prefer "any number of JSON texts, all encoded in > UTF-8,". I'll take this. > I also just now noticed that there is a typo in the abstract: it > should say "each prefix*ed*". Fixed. > > It also looks like ASCII names for RS and LF are being mixed w/Unicode > > codepoints in the second sentence in the abstract. I'm not sure that's > > a good thing to do, especially as the body of the draft refers to RS and > > LF as being ASCII. Here are a couple of changes that would remedy this: > > > > "an Record Separator (U+001E)" -> "an ASCII Record Separator (0x1E)" > > "a newline character (U+000A)" -> "an ASCII newline character (0x0A)" > > With John Cowan's change ("an ASCII Line Feed character (0x1E)" > instead of "an ASCII Record Separator (0x1E)"), that would indeed be > clearer. OK. > > Section 2 JSON Text Sequence Format: > > > > I suggest adding this sentence as a separate paragraph at the end of this > > section (i.e., just before Section 2.1): > > > > JSON text sequences MUST use UTF-8 encoding; other encodings of JSON > > (i.e., UTF-16 and UTF-32) MUST NOT be used. > > That seems like a good clarifying addition as well. > > Nico: could you issue a -11 with the above changes? I'll confirm the posting seconds from sending this.
- Gen-ART and OPS-Dir review of draft-ietf-json-tex… Black, David
- Re: [Json] Gen-ART and OPS-Dir review of draft-ie… John Cowan
- Re: [Json] Gen-ART and OPS-Dir review of draft-ie… Paul Hoffman
- RE: [Json] Gen-ART and OPS-Dir review of draft-ie… Black, David
- Re: [Json] Gen-ART and OPS-Dir review of draft-ie… Nico Williams
- Re: [Json] Gen-ART and OPS-Dir review of draft-ie… Nico Williams
- RE: [Json] Gen-ART and OPS-Dir review of draft-ie… Manger, James
- RE: [Json] Gen-ART and OPS-Dir review of draft-ie… Black, David
- Re: [Json] Gen-ART and OPS-Dir review of draft-ie… Nico Williams
- RE: [Json] Gen-ART and OPS-Dir review of draft-ie… Black, David
- Re: [Json] Gen-ART and OPS-Dir review of draft-ie… Nico Williams
- Re: [Json] Gen-ART and OPS-Dir review of draft-ie… Nico Williams
- Re: [Json] Gen-ART and OPS-Dir review of draft-ie… John Cowan
- Re: [Json] Gen-ART and OPS-Dir review of draft-ie… John Cowan
- Re: [Json] Gen-ART and OPS-Dir review of draft-ie… John Cowan
- Re: [Json] Gen-ART and OPS-Dir review of draft-ie… Patrik Fältström
- Re: [Json] Gen-ART and OPS-Dir review of draft-ie… Jari Arkko
- RE: [Json] Gen-ART and OPS-Dir review of draft-ie… Black, David