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

Reply via email to