Re: [Json] Comments by convention

"Pete Cordell" <petejson@codalogic.com> Fri, 07 June 2013 18:41 UTC

Return-Path: <petejson@codalogic.com>
X-Original-To: json@ietfa.amsl.com
Delivered-To: json@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 2912B21F9948 for <json@ietfa.amsl.com>; Fri, 7 Jun 2013 11:41:36 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: 1.667
X-Spam-Level: *
X-Spam-Status: No, score=1.667 tagged_above=-999 required=5 tests=[AWL=0.001, BAYES_50=0.001, SARE_HEAD_XUNSENT=1.666]
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 DE-pEm4ROhge for <json@ietfa.amsl.com>; Fri, 7 Jun 2013 11:41:30 -0700 (PDT)
Received: from codalogic.com (codalogic.com [94.136.60.219]) by ietfa.amsl.com (Postfix) with ESMTP id DE37821F8793 for <json@ietf.org>; Fri, 7 Jun 2013 11:41:29 -0700 (PDT)
Received: (qmail 23617 invoked from network); 7 Jun 2013 19:41:28 +0100
Received: from host86-169-212-62.range86-169.btcentralplus.com (HELO codalogic) (86.169.212.62) by codalogic.com with (RC4-MD5 encrypted) SMTP; 7 Jun 2013 19:41:28 +0100
Message-ID: <1650E434884344059BCABB683DA92C99@codalogic>
From: Pete Cordell <petejson@codalogic.com>
To: Douglas Crockford <douglas@crockford.com>, json@ietf.org
References: <51B2109A.30506@crockford.com>
Date: Fri, 07 Jun 2013 19:41:11 +0100
X-Unsent: 1
MIME-Version: 1.0
x-vipre-scanned: 00123EA700484A00123FF4
Content-Type: text/plain; format="flowed"; charset="iso-8859-1"; reply-type="response"
Content-Transfer-Encoding: 7bit
X-Priority: 3
X-MSMail-Priority: Normal
X-Mailer: Microsoft Outlook Express 6.00.2900.5931
X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157
Subject: Re: [Json] Comments by convention
X-BeenThere: json@ietf.org
X-Mailman-Version: 2.1.12
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: Fri, 07 Jun 2013 18:41:36 -0000

Original Message From: "Douglas Crockford" 
> On 6/7/2013 9:31 AM, Pete Cordell wrote:
>> For example:
>>
>>    "order": {
>>            "//": "An order item",
>>            "// description": "A short description of the item ordered",
>>            "description": "1TB HDD",
>>            "// price": "The price in USD",
>>            "price": 123.45 }
>>
>> How much goes up in smoke if we do that? 
> That belongs in the best practices document.

OK.  I'll try to remember to shake the tree then.

Pete Cordell
Codalogic Ltd