Re: [Json] Wording on encoding; removing the table

Larry Masinter <masinter@adobe.com> Mon, 25 November 2013 05:59 UTC

Return-Path: <masinter@adobe.com>
X-Original-To: json@ietfa.amsl.com
Delivered-To: json@ietfa.amsl.com
Received: from localhost (ietfa.amsl.com [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id B3C301AC3FA for <json@ietfa.amsl.com>; Sun, 24 Nov 2013 21:59:18 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -0.7
X-Spam-Level:
X-Spam-Status: No, score=-0.7 tagged_above=-999 required=5 tests=[RCVD_IN_DNSWL_LOW=-0.7] autolearn=ham
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 b_ovNkVB04mF for <json@ietfa.amsl.com>; Sun, 24 Nov 2013 21:59:16 -0800 (PST)
Received: from na01-bn1-obe.outbound.protection.outlook.com (mail-bn1lp0158.outbound.protection.outlook.com [207.46.163.158]) by ietfa.amsl.com (Postfix) with ESMTP id 805ED1ABBB1 for <json@ietf.org>; Sun, 24 Nov 2013 21:59:16 -0800 (PST)
Received: from BL2PR02MB307.namprd02.prod.outlook.com (10.141.91.21) by BL2PR02MB274.namprd02.prod.outlook.com (10.141.89.145) with Microsoft SMTP Server (TLS) id 15.0.820.5; Mon, 25 Nov 2013 05:59:15 +0000
Received: from BL2PR02MB307.namprd02.prod.outlook.com ([10.141.91.21]) by BL2PR02MB307.namprd02.prod.outlook.com ([10.141.91.21]) with mapi id 15.00.0800.005; Mon, 25 Nov 2013 05:59:15 +0000
From: Larry Masinter <masinter@adobe.com>
To: Pete Cordell <petejson@codalogic.com>
Thread-Topic: [Json] Wording on encoding; removing the table
Thread-Index: AQHO59Nya/85CLOg6UC7m1NK+zF1YZoyk6fhgALbsIA=
Date: Mon, 25 Nov 2013 05:59:13 +0000
Message-ID: <7468141ce23a4984a99486c70284ef72@BL2PR02MB307.namprd02.prod.outlook.com>
References: <v8av89128j49csd5bb5ba2rqrgschs4c79@hive.bjoern.hoehrmann.de> <BE35B0E6-6C71-47EB-BA29-08A32935D20E@vpnc.org> <7404D1DCC5E84DC3B8F8CD300274962D@codalogic>
In-Reply-To: <7404D1DCC5E84DC3B8F8CD300274962D@codalogic>
Accept-Language: en-US
Content-Language: en-US
X-MS-Has-Attach:
X-MS-TNEF-Correlator:
x-originating-ip: [12.189.131.5]
x-forefront-prvs: 0041D46242
x-forefront-antispam-report: SFV:NSPM; SFS:(189002)(199002)(47976001)(50986001)(47736001)(49866001)(46102001)(76482001)(85306002)(56816003)(54356001)(53806001)(76796001)(76786001)(76576001)(81816001)(15975445006)(80976001)(83322001)(19580395003)(81686001)(51856001)(63696002)(47446002)(79102001)(69226001)(74706001)(80022001)(66066001)(65816001)(74662001)(74502001)(31966008)(81342001)(74876001)(74316001)(15202345003)(56776001)(54316002)(77982001)(59766001)(74366001)(87266001)(83072001)(33646001)(87936001)(81542001)(4396001)(2656002)(24736002); DIR:OUT; SFP:; SCL:1; SRVR:BL2PR02MB274; H:BL2PR02MB307.namprd02.prod.outlook.com; CLIP:12.189.131.5; FPR:; RD:InfoNoRecords; MX:1; A:1; LANG:en;
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0
X-OriginatorOrg: adobe.com
Cc: "json@ietf.org" <json@ietf.org>
Subject: Re: [Json] Wording on encoding; removing the table
X-BeenThere: json@ietf.org
X-Mailman-Version: 2.1.15
Precedence: list
List-Id: "JavaScript Object Notation \(JSON\) WG mailing list" <json.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/json>, <mailto:json-request@ietf.org?subject=unsubscribe>
List-Archive: <http://www.ietf.org/mail-archive/web/json/>
List-Post: <mailto:json@ietf.org>
List-Help: <mailto:json-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/json>, <mailto:json-request@ietf.org?subject=subscribe>
X-List-Received-Date: Mon, 25 Nov 2013 05:59:18 -0000

" The transfer encoding
    used to represent the characters on-the-wire is beyond the scope
    of this document."

On the contrary, it seems to me that this document is (or should be)
MAINLY ABOUT normatively establishing how JSON text is encoded
in an application/json message body "on the wire" -- something
ECMA 404 doesn't do.


JSON in ECMA-404 is a sequence of Unicode codepoints.
application/json is a sequence of octets. Those octets are used
to represent ECMA 404 JSON text, in the manner prescribed
in this document.

Insofar as ECMA 404 is updated to include the substance from this
draft (guidelines for encoding JSON text and registration of
the media type), then anything that remains (implementation
advice, non-normative ABNF) could remain in IETF, and
obsolete 4627 but normatively point to 404.

This might help resolve some of the liaison  issues as well
as clarifying the relationship of the two documents.

>From a "first principles" point of view:

* MIME types for a format are best defined in the same document 
  which defines the format. That sometimes means enhancing
  the format definition to talk about encodings in bytes in a way
  that it wouldn't otherwise be defined.

*  Having two overlapping normative documents with different
   change control is bad for multiple reasons. Even if non-optimal
   for one side, it's better to avoid overlap; one way to do that
   is by making one document    normatively reference the other,
   even if it (for information) it restates some of the information.

Larry
--
http://larry.masinter.net