+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 > 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 namens Hiranya Jayathilaka > Verzonden: za 19-6-2010 10:34 > Aan: 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> 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> > 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 <ka...@wso2.com>] > >> Verzonden: vr 18-6-2010 19:09 > >> Aan: 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> wrote: > >> > >> > Hi, > >> > > >> > On Fri, Jun 18, 2010 at 8:54 PM, Hofman, Peter (NL) < > >> > 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 > >> > 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 > >> 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 > > p...@wso2.com > > > > 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 > > 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; 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 > 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; 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