+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

Reply via email to