Re: [ietf-types] Request for review: application/json-patch

"Paul C. Bryan" <paul.bryan@forgerock.com> Mon, 24 October 2011 21:24 UTC

Return-Path: <paul.bryan@forgerock.com>
X-Original-To: ietf-types@ietfa.amsl.com
Delivered-To: ietf-types@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 0434F11E8115 for <ietf-types@ietfa.amsl.com>; Mon, 24 Oct 2011 14:24:30 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -6.599
X-Spam-Level:
X-Spam-Status: No, score=-6.599 tagged_above=-999 required=5 tests=[AWL=0.000, BAYES_00=-2.599, RCVD_IN_DNSWL_MED=-4]
Received: from mail.ietf.org ([12.22.58.30]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 5uYtaHR84qLm for <ietf-types@ietfa.amsl.com>; Mon, 24 Oct 2011 14:24:29 -0700 (PDT)
Received: from eu1sys200aog115.obsmtp.com (eu1sys200aog115.obsmtp.com [207.126.144.139]) by ietfa.amsl.com (Postfix) with SMTP id AAA3811E8114 for <ietf-types@ietf.org>; Mon, 24 Oct 2011 14:24:28 -0700 (PDT)
Received: from mail-gx0-f171.google.com ([209.85.161.171]) (using TLSv1) by eu1sys200aob115.postini.com ([207.126.147.11]) with SMTP; Mon, 24 Oct 2011 21:24:28 UTC
Received: by mail-gx0-f171.google.com with SMTP id v5so8726992ggn.16 for <ietf-types@ietf.org>; Mon, 24 Oct 2011 14:24:23 -0700 (PDT)
Received: by 10.68.30.36 with SMTP id p4mr19823836pbh.86.1319491463659; Mon, 24 Oct 2011 14:24:23 -0700 (PDT)
Received: from [192.168.1.8] (S0106a021b762dbb3.vf.shawcable.net. [174.1.40.184]) by mx.google.com with ESMTPS id jm5sm1447431pbc.1.2011.10.24.14.24.22 (version=TLSv1/SSLv3 cipher=OTHER); Mon, 24 Oct 2011 14:24:22 -0700 (PDT)
Message-ID: <1319491461.23040.13.camel@neutron>
From: "Paul C. Bryan" <paul.bryan@forgerock.com>
To: ietf-types@ietf.org
Date: Mon, 24 Oct 2011 14:24:21 -0700
In-Reply-To: <vpkba751umlb8n8mklpajvkg7a45udhb7n@hive.bjoern.hoehrmann.de>
References: <1319490143.23040.8.camel@neutron> <vpkba751umlb8n8mklpajvkg7a45udhb7n@hive.bjoern.hoehrmann.de>
Content-Type: text/plain; charset="UTF-8"
X-Mailer: Evolution 3.0.3-2
Content-Transfer-Encoding: 7bit
Mime-Version: 1.0
Subject: Re: [ietf-types] Request for review: application/json-patch
X-BeenThere: ietf-types@ietf.org
X-Mailman-Version: 2.1.12
Precedence: list
List-Id: "Media \(MIME\) type review" <ietf-types.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/ietf-types>, <mailto:ietf-types-request@ietf.org?subject=unsubscribe>
List-Archive: <http://www.ietf.org/mail-archive/web/ietf-types>
List-Post: <mailto:ietf-types@ietf.org>
List-Help: <mailto:ietf-types-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/ietf-types>, <mailto:ietf-types-request@ietf.org?subject=subscribe>
X-List-Received-Date: Mon, 24 Oct 2011 21:24:30 -0000

On Mon, 2011-10-24 at 23:11 +0200, Bjoern Hoehrmann wrote:
> * Paul C. Bryan wrote:
> >The Internet media type for a JSON Patch document is application/
> >json-patch.
> 
> What is your reasoning behind not using the "+json" convention?

In a previous draft, it was "application/patch+json", but I was advised
that:

a) application/schema was possibly too basic a base type, and
b) there is no formalization around +json extension yet.

> >Type name:  application
> >
> >Subtype name:  json-patch
> >
> >Required parameters:  none
> >
> >Optional parameters:   none
> >
> >Encoding considerations:
> >   Per JSON [RFC4627]: 8bit if UTF-8; binary if UTF-16 or UTF-32.
> 
> Either say something like "Same as for application/json." or "binary".
> It would seem to me that RFC 4627 is mistaken in using "8bit" as that
> is "The content of the media type consists solely of CRLF-delimited
> 8bit text." but JSON does not require CRLF.

Okay, thanks.

> >Applications that use this media type:
> >   HTTP clients and servers.
> 
> Well. Revision control systems for instance might use it.

True. Is there a way to just indicate general purpose usage instead of
trying to enumerate all the specific types of applications I could
imagine making use of this?

> >Change controller:  Paul C. Bryan <paul.bryan@forgerock.com>
> 
> This would have to be some standards organization like "The IETF."

Okay.

Thanks for the review.

Paul