I think the proposal is to add an optional <documentation> element (with content xs:any) as a valid child of every mediator and to have an optional "name" attribute for all mediators to as well.
Sanjiva. On Sun, Jun 20, 2010 at 11:54 PM, Supun Kamburugamuva <[email protected]>wrote: > 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 <[email protected]> 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) > >> <[email protected] <mailto:[email protected]>> 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: [email protected] > >> <mailto:[email protected]> namens Hiranya Jayathilaka > >> Verzonden: za 19-6-2010 10:34 > >> Aan: [email protected] <mailto:[email protected]> > >> Onderwerp: Re: [Carbon-dev] Adding a comment tag to synapse > >> configuration > >> > >> Hi Paul, > >> > >> On Sat, Jun 19, 2010 at 12:23 PM, Paul Fremantle <[email protected] > >> <mailto:[email protected]>> 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) > >> <[email protected] <mailto:[email protected]>> 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:[email protected] > >> <mailto:[email protected]> <[email protected] <mailto:[email protected]>>] > >> >> Verzonden: vr 18-6-2010 19:09 > >> >> Aan: [email protected] <mailto:[email protected]> > >> >> 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 < > >> >> [email protected] <mailto:[email protected]>> > >> wrote: > >> >> > >> >> > Hi, > >> >> > > >> >> > On Fri, Jun 18, 2010 at 8:54 PM, Hofman, Peter (NL) < > >> >> > [email protected] <mailto:[email protected]>> > 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 > >> >> > [email protected] <mailto:[email protected]> > >> >> > 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 > >> >> [email protected] <mailto:[email protected]> > >> >> 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> > >> > [email protected] <mailto:[email protected]> > >> > > >> > 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 > >> > [email protected] <mailto:[email protected]> > >> > https://mail.wso2.org/cgi-bin/mailman/listinfo/carbon-dev > >> > > >> > > >> > >> > >> -- > >> Hiranya Jayathilaka > >> Senior Software Engineer; > >> WSO2 Inc.; http://wso2.org > >> E-mail: [email protected] <mailto:[email protected]>; 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 > >> [email protected] <mailto:[email protected]> > >> https://mail.wso2.org/cgi-bin/mailman/listinfo/carbon-dev > >> > >> > >> > >> > >> -- > >> Sanjiva Weerawarana, Ph.D. > >> Founder, Chairman & CEO; WSO2, Inc.; http://wso2.com/ > >> email: [email protected] <mailto:[email protected]>; 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 > >> [email protected] > >> 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: [email protected]; 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 > > [email protected] > > https://mail.wso2.org/cgi-bin/mailman/listinfo/carbon-dev > > > > _______________________________________________ > Carbon-dev mailing list > [email protected] > https://mail.wso2.org/cgi-bin/mailman/listinfo/carbon-dev > -- Sanjiva Weerawarana, Ph.D. Founder, Chairman & CEO; WSO2, Inc.; http://wso2.com/ email: [email protected]; 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 [email protected] https://mail.wso2.org/cgi-bin/mailman/listinfo/carbon-dev
