I did initiate a thread. It may not complete as I cannot grasp the final decisions clearly from this thread. Please verify.
Thanks, Supun.. On Sat, Jun 19, 2010 at 11:25 AM, Ruwan Linton <ru...@wso2.com> wrote: > +1 > > My personal belief is that we could preserve XML comments as well, but I > don't have time at this moment to do a PoC of that, and also even with > having that feature it is really good to have a <documentation> child > element and a @name attribute for all the mediators, and a doc tag for > all the pieces in synapse configuration. > > Well, this should be discussed on the synapse-dev, not on this list :-( > > Can some one bring this onto the synapse dev list?? summarizing this thread. > > Thanks, > Ruwan > > Sanjiva Weerawarana wrote: >> +1 for <documentation> instead of <comments> .. that's actually very >> consistent with XSD and WSDL too! >> >> Sanjiva. >> >> On Sat, Jun 19, 2010 at 5:28 PM, Hofman, Peter (NL) >> <peter.hof...@logica.com <mailto:peter.hof...@logica.com>> wrote: >> >> I think you want 2 additional optional fields (either element or >> attribute). Well, at least I would want this :) >> 1) a user given name for the mediator, which allows to give a >> short description which will help understanding the sequence. >> 2) a description or documentation field, in which a description of >> the use of the mediator can be given. >> >> Peter >> >> >> -----Oorspronkelijk bericht----- >> Van: carbon-dev-boun...@wso2.org >> <mailto:carbon-dev-boun...@wso2.org> namens Hiranya Jayathilaka >> Verzonden: za 19-6-2010 10:34 >> Aan: carbon-dev@wso2.org <mailto:carbon-dev@wso2.org> >> Onderwerp: Re: [Carbon-dev] Adding a comment tag to synapse >> configuration >> >> Hi Paul, >> >> On Sat, Jun 19, 2010 at 12:23 PM, Paul Fremantle <p...@wso2.com >> <mailto:p...@wso2.com>> wrote: >> >> > What about simply adding an optional attribute to each mediator? >> > >> >> I also thought about this. But in some cases, users might want to >> associate >> rather lengthy comments with mediators. In such cases this >> approach might >> not be the best option. The comment tag is a much better approach >> in that >> sense. >> >> Thanks, >> Hiranya >> >> >> > Paul >> > >> > >> > On 18 June 2010 21:38, Hofman, Peter (NL) >> <peter.hof...@logica.com <mailto:peter.hof...@logica.com>> wrote: >> > >> >> Hi, >> >> >> >> that is great! >> >> When does it have to be finished? The last commit is from 4 >> weeks ago, and >> >> of all mediators it only contains the 'in' mediator. >> >> What is the plan for using it? Code generation? Validation? >> >> >> >> Cheers, >> >> >> >> Peter >> >> >> >> >> >> -----Oorspronkelijk bericht----- >> >> Van: Kasun Indrasiri [mailto:ka...@wso2.com >> <mailto:ka...@wso2.com> <ka...@wso2.com <mailto:ka...@wso2.com>>] >> >> Verzonden: vr 18-6-2010 19:09 >> >> Aan: carbon-dev@wso2.org <mailto:carbon-dev@wso2.org> >> >> CC: Hofman, Peter (NL) >> >> >> >> Onderwerp: Re: [Carbon-dev] Adding a comment tag to synapse >> configuration >> >> >> >> Hi, >> >> >> >> For the current synapse trunk, we have a scheme[1] for the Synapse >> >> Configuration Language. >> >> >> >> Thanks. >> >> Kasun >> >> >> >> >> >> [1] >> >> >> >> >> >> http://old.nabble.com/Synapse-schema-and-the-changes-to-the-configuration-builders-td28572189.html >> >> >> >> On Fri, Jun 18, 2010 at 10:05 PM, Asiri Rathnayake < >> >> asiri.rathnay...@gmail.com <mailto:asiri.rathnay...@gmail.com>> >> wrote: >> >> >> >> > Hi, >> >> > >> >> > On Fri, Jun 18, 2010 at 8:54 PM, Hofman, Peter (NL) < >> >> > peter.hof...@logica.com <mailto:peter.hof...@logica.com>> wrote: >> >> > >> >> >> I had a discussion about this with a colleague of mine. He >> proposed >> >> >> another solution: adding attributes in the synapse schema >> definition. >> >> >> I think either (optional) attributes or optional elements >> are far >> >> better >> >> >> than (ab)using xml comments. >> >> >> >> >> > AFAIK there is no schema definition for synapse configuration >> language. >> >> See >> >> > >> >> > >> >> >> >> http://old.nabble.com/Is-there-an-schema-for-Apache-Synapse--td28276561.html >> >> > >> >> > - Asiri >> >> > >> >> > >> >> > _______________________________________________ >> >> > Carbon-dev mailing list >> >> > Carbon-dev@wso2.org <mailto:Carbon-dev@wso2.org> >> >> > https://mail.wso2.org/cgi-bin/mailman/listinfo/carbon-dev >> >> > >> >> > >> >> >> >> >> >> -- >> >> Kasun Indrasiri >> >> Senior Software Engineer >> >> WSO2, Inc.; http://wso2.com >> >> lean.enterprise.middleware >> >> >> >> cell: +94 71 536 4128 >> >> Blog : http://kasunpanorama.blogspot.com/ >> >> >> >> >> >> Please help Logica to respect the environment by not printing >> this email / >> >> Pour contribuer comme Logica au respect de l'environnement, >> merci de ne pas >> >> imprimer ce mail / Bitte drucken Sie diese Nachricht nicht aus >> und helfen >> >> Sie so Logica dabei, die Umwelt zu schützen. / Por favor ajude >> a Logica a >> >> respeitar o ambiente não imprimindo este correio electrónico. >> This e-mail >> >> and any attachment is for authorised use by the intended >> recipient(s) only. >> >> It may contain proprietary material, confidential information >> and/or be >> >> subject to legal privilege. It should not be copied, disclosed >> to, retained >> >> or used by, any other party. If you are not an intended >> recipient then >> >> please promptly delete this e-mail and any attachment and all >> copies and >> >> inform the sender. Thank you. >> >> >> >> _______________________________________________ >> >> Carbon-dev mailing list >> >> Carbon-dev@wso2.org <mailto:Carbon-dev@wso2.org> >> >> https://mail.wso2.org/cgi-bin/mailman/listinfo/carbon-dev >> >> >> >> >> > >> > >> > -- >> > Paul Fremantle >> > CTO and Co-Founder, WSO2 >> > OASIS WS-RX TC Co-chair, VP, Apache Synapse >> > >> > Office: +44 844 484 8143 >> > Cell: +44 798 447 4618 >> > >> > blog: http://pzf.fremantle.org >> > twitter.com/pzfreo <http://twitter.com/pzfreo> >> > p...@wso2.com <mailto:p...@wso2.com> >> > >> > wso2.com <http://wso2.com> Lean Enterprise Middleware >> > >> > Disclaimer: This communication may contain privileged or other >> confidential >> > information and is intended exclusively for the addressee/s. If >> you are not >> > the intended recipient/s, or believe that you may have received this >> > communication in error, please reply to the sender indicating >> that fact and >> > delete the copy you received and in addition, you should not >> print, copy, >> > retransmit, disseminate, or otherwise use the information >> contained in this >> > communication. Internet communications cannot be guaranteed to >> be timely, >> > secure, error or virus-free. The sender does not accept >> liability for any >> > errors or omissions. >> > >> > _______________________________________________ >> > Carbon-dev mailing list >> > Carbon-dev@wso2.org <mailto:Carbon-dev@wso2.org> >> > https://mail.wso2.org/cgi-bin/mailman/listinfo/carbon-dev >> > >> > >> >> >> -- >> Hiranya Jayathilaka >> Senior Software Engineer; >> WSO2 Inc.; http://wso2.org >> E-mail: hira...@wso2.com <mailto:hira...@wso2.com>; Mobile: +94 >> 77 633 3491 >> Blog: http://techfeast-hiranya.blogspot.com >> >> >> >> Please help Logica to respect the environment by not printing this >> email / Pour contribuer comme Logica au respect de >> l'environnement, merci de ne pas imprimer ce mail / Bitte drucken >> Sie diese Nachricht nicht aus und helfen Sie so Logica dabei, die >> Umwelt zu schützen. / Por favor ajude a Logica a respeitar o >> ambiente nao imprimindo este correio electronico. >> >> >> >> This e-mail and any attachment is for authorised use by the >> intended recipient(s) only. It may contain proprietary material, >> confidential information and/or be subject to legal privilege. It >> should not be copied, disclosed to, retained or used by, any other >> party. If you are not an intended recipient then please promptly >> delete this e-mail and any attachment and all copies and inform >> the sender. Thank you. >> >> >> _______________________________________________ >> Carbon-dev mailing list >> Carbon-dev@wso2.org <mailto:Carbon-dev@wso2.org> >> https://mail.wso2.org/cgi-bin/mailman/listinfo/carbon-dev >> >> >> >> >> -- >> Sanjiva Weerawarana, Ph.D. >> Founder, Chairman & CEO; WSO2, Inc.; http://wso2.com/ >> email: sanj...@wso2.com <mailto:sanj...@wso2.com>; phone: +1 408 754 >> 7388 x51726; cell: +94 77 787 6880 | +1 650 265 8311 >> blog: http://sanjiva.weerawarana.org/ >> >> Lean . Enterprise . Middleware >> ------------------------------------------------------------------------ >> >> _______________________________________________ >> Carbon-dev mailing list >> Carbon-dev@wso2.org >> https://mail.wso2.org/cgi-bin/mailman/listinfo/carbon-dev >> > > > -- > Ruwan Linton > Software Architect & Product Manager, WSO2 ESB; http://wso2.org/esb > WSO2 Inc.; http://wso2.com > > Lean . Enterprise . Middleware > > phone: +1 408 754 7388 ext 51789 > email: ru...@wso2.com; cell: +94 77 341 3097 > blog: http://blog.ruwan.org > linkedin: http://www.linkedin.com/in/ruwanlinton > tweet: http://twitter.com/ruwanlinton > > > _______________________________________________ > Carbon-dev mailing list > Carbon-dev@wso2.org > https://mail.wso2.org/cgi-bin/mailman/listinfo/carbon-dev > _______________________________________________ Carbon-dev mailing list Carbon-dev@wso2.org https://mail.wso2.org/cgi-bin/mailman/listinfo/carbon-dev