Re: [Json] Comments by convention

[Douglas Crockford <[e-mail]>]

On 6/7/2013 9:31 AM, Pete Cordell wrote:
> I along with many wish JSON included comments.  Since they can't 
> retrospectively be added, what are the prospects of documenting a 
> convention for including comments in a JSON message?
>
> For example, something along the lines of:
>
> 2.6 Comments
>
> JSON has no native ability to represent comments.  Instead, by 
> convention, unless overridden by a protocol definition, comments can 
> be represented by name/value pairs (a.k.a. members) with string values 
> of the form:
>
>    "//": "This is a comment"
>
> Comments can be associated with a particular member within an object 
> using a comment name of the form "// foo" where "foo" is the name of 
> the member to which the comment applies.
>
> 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.