On Sun, Jun 20, 2010 at 11:53 PM, Supun Kamburugamuva <[email protected]>wrote:
> Hi All,
>
> It is a good thing to facilitate documentation within the configuration
> model it self.
>
+1 for the Idea. This will be even more valuable if in the future if
synapse starts to ships some tooling support with it to developers to use
the configuration language( ex : say a eclipse plugin). So while configuring
in a IDE developers will be able to see the documentation associated with
each and every configuration element.(like how we can view java docs). by
pulling the documentation element associated with the configuration element
(mediator , Registry etc ..)
> 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..
>
>
>
>
--
Charith Dhanushka Wickramarachchi
http://charithwiki.blogspot.com/
