synapse-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Kasun Indrasiri <kasun...@gmail.com>
Subject Re: Facilitating documentation in Synapse Configuration model
Date Mon, 21 Jun 2010 05:39:35 GMT
+1
IMO, adding <documentation> tag is pretty straight forward than preserving
the comments during building/serialization.

-Kasun
On Sun, Jun 20, 2010 at 11:53 PM, Supun Kamburugamuva <supun06@gmail.com>wrote:

> Hi All,
>
> It is a good thing to facilitate documentation within the configuration
> model it self. At the moment users can use XML comments. But when synapse
> configuration model is built and serialized these XML comments get lost. So
> it is better to have support for documentation comments.
>
> So one option is to add a documentation tag and a optional attribute to the
> XML configuration elements to facilitate the documentations. Please add your
> thoughts and comments.
>
> Thanks,
> Supun..
>
>
>
>


-- 
Kasun Indrasiri
Senior Software Engineer,
WSO2 Inc. - "Lean . Enterprise . Middleware" - http://www.wso2.com/
Blog : http://kasunpanorama.blogspot.com/

Mime
View raw message