Hi all, Yes, not being able to have comments is a serious miss in JSON AFAIU, because there is no way to document alternative options as in the case of XML. That's the reason why I asked what's our convention of adding comments/documentation. Some people have used the "_comment" element. If what Madhuka explains is the convention in Jaggery, we can follow that in AM/GS/G-Reg etc.
Thanks, Senaka. On Sun, Oct 28, 2012 at 11:24 PM, Nuwan Bandara <[email protected]> wrote: > Hi Senaka, > > there is no such thing called comments in JSON. :) > > Regards, > /Nuwan > > > On Sun, Oct 28, 2012 at 8:31 AM, Madhuka Udantha <[email protected]> wrote: > >> Hi, >> >> I don't believe we can have an actual comment in json[1]. The JSON should >> all be data, and if you include a comment, then it will be data too. In >> jaggery still it is same. We can have a designated data element called >> "_comment". >> >> Here sample that you can try out. >> eg: >> >> { >> *"displayName_comment":"give the jaggery app name", * >> "displayName":"Coffee Shop", >> "urlMappings":[ >> { >> "url":"/orders/*", >> * "url_comment":"Comments for url mapping on URL",* >> "path":"/controller/order.jag" >> } >> >> ] >> } >> >> It is drawback of json. >> >> References >> [1] http://www.json.org/ >> >> On Sun, Oct 28, 2012 at 1:30 PM, Senaka Fernando <[email protected]> wrote: >> >>> Hi all, >>> >>> $subject? >>> >>> Thanks, >>> Senaka. >>> >>> -- >>> *Senaka Fernando* >>> Member - Integration Technologies Management Committee; >>> Technical Lead; WSO2 Inc.; http://wso2.com* >>> Member; Apache Software Foundation; http://apache.org >>> >>> E-mail: senaka AT wso2.com >>> **P: +1 408 754 7388; ext: 51736*; *M: +94 77 322 1818 >>> Linked-In: http://linkedin.com/in/senakafernando >>> >>> *Lean . Enterprise . Middleware >>> >>> >> >> >> -- >> *Madhuka* Udantha >> http://madhukaudantha.blogspot.com/ >> >> > > > -- > *Thanks & Regards, > > Nuwan Bandara > Associate Technical Lead & Member, MC, Development Technologies > WSO2 Inc. - lean . enterprise . middleware | http://wso2.com > blog : http://nuwanbando.com; email: [email protected]; phone: +94 11 763 > 9629 > * > <http://www.nuwanbando.com/> > -- *Senaka Fernando* Member - Integration Technologies Management Committee; Technical Lead; WSO2 Inc.; http://wso2.com* Member; Apache Software Foundation; http://apache.org E-mail: senaka AT wso2.com **P: +1 408 754 7388; ext: 51736*; *M: +94 77 322 1818 Linked-In: http://linkedin.com/in/senakafernando *Lean . Enterprise . Middleware
_______________________________________________ Dev mailing list [email protected] http://wso2.org/cgi-bin/mailman/listinfo/dev
