Re: [Json] Comments by convention

Adding to your proposal, I'd like it stated that comments are also first class name:value data pairs; ie if I call (pseudo code):

Jsonobject.get("// description");

Then I will get the value "A short description of the item ordered". Obviously this is also backward compatible.

-----------------
Vinny
www.jsontest.com

On Jun 7, 2013, at 11:31 AM, "Pete Cordell" <petejson@codalogic.com> 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?
> 
> Pete Cordell
> Codalogic Ltd
> C++ tools for C++ programmers, http://codalogic.com
> Read & write XML in C++, http://www.xml2cpp.com
> 
> _______________________________________________
> json mailing list
> json@ietf.org
> https://www.ietf.org/mailman/listinfo/json