Re: [apps-discuss] JSON Patch: Shortening operation names?

Graham Klyne <GK@ninebynine.org> Tue, 06 December 2011 11:55 UTC

Return-Path: <GK@ninebynine.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 5345C21F8A4B for <apps-discuss@ietfa.amsl.com>; Tue, 6 Dec 2011 03:55:36 -0800 (PST)
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=[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 TJeZDNKodh6n for <apps-discuss@ietfa.amsl.com>; Tue, 6 Dec 2011 03:55:35 -0800 (PST)
Received: from relay3.mail.ox.ac.uk (relay3.mail.ox.ac.uk [163.1.2.165]) by ietfa.amsl.com (Postfix) with ESMTP id 5B96021F8A35 for <apps-discuss@ietf.org>; Tue, 6 Dec 2011 03:55:35 -0800 (PST)
Received: from smtp2.mail.ox.ac.uk ([163.1.2.205]) by relay3.mail.ox.ac.uk with esmtp (Exim 4.75) (envelope-from <GK@ninebynine.org>) id 1RXtcR-0005p8-CG; Tue, 06 Dec 2011 11:55:31 +0000
Received: from gklyne.plus.com ([80.229.154.156] helo=Eskarina.local) by smtp2.mail.ox.ac.uk with esmtpsa (TLSv1:AES256-SHA:256) (Exim 4.69) (envelope-from <GK@ninebynine.org>) id 1RXtcR-0001ly-8O; Tue, 06 Dec 2011 11:55:31 +0000
Message-ID: <4EDDEE37.1020501@ninebynine.org>
Date: Tue, 06 Dec 2011 10:28:07 +0000
From: Graham Klyne <GK@ninebynine.org>
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.5; rv:6.0) Gecko/20110812 Thunderbird/6.0
MIME-Version: 1.0
To: "Paul C. Bryan" <paul.bryan@forgerock.com>
References: <1323136558.12382.28.camel@neutron>
In-Reply-To: <1323136558.12382.28.camel@neutron>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
X-Oxford-Username: zool0635
Cc: IETF Apps Discuss <apps-discuss@ietf.org>
Subject: Re: [apps-discuss] JSON Patch: Shortening operation names?
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: Tue, 06 Dec 2011 11:55:36 -0000

I'd be inclined to stick with the readable names, unless there's a clear case 
that the extra bytes will have significant effect on performance.

[[
Donald Knuth made the following two statements on optimization:

"We should forget about small efficiencies, say about 97% of the time: premature 
optimization is the root of all evil"[2]

(He also attributed the quote to Tony Hoare several years later,[3] although 
this might have been an error as Hoare disclaims having coined the phrase.[4])

"In established engineering disciplines a 12 % improvement, easily obtained, is 
never considered marginal and I believe the same viewpoint should prevail in 
software engineering"[2]
]]
-- http://en.wikipedia.org/wiki/Program_optimization#When_to_optimize

I'd be surprised if, in practice, the shorter names would yield a >10% improvement.

#g
--

On 06/12/2011 01:55, Paul C. Bryan wrote:
> It's been suggested on more than one occasion that the operation names
> in JSON Patch are too verbose. I've countered with the point that if you
> transmit via HTTP and "Content-Encoding: gzip", the verbosity is nicely
> compressed out. This argument has served me well (insofar as it tends to
> silence most critics), but I continue to get challenged on this point.
> I'm curious to know what position APPSAWG members may have. Should I use
> "rm" or even "-" instead of the more verbose "remove"?
>
> Paul
>
>
>
>
> _______________________________________________
> apps-discuss mailing list
> apps-discuss@ietf.org
> https://www.ietf.org/mailman/listinfo/apps-discuss