Supun, Sorry for jumping so late :-(
Why do we need different interfaces, I personally hate adding a lot of interfaces. If you think of granulating the interfaces, the final out come will be you will have separate interfaces for each and every method, so I prefer going for a single interface with documentation stuff and filename, name and all other common stuff, the interface could be SynapseArtifact. Thanks, Ruwan On Tue, Jun 22, 2010 at 5:30 PM, Charith Wickramarachchi < [email protected]> wrote: > > > 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/ > > -- Ruwan Linton Software Architect & Product Manager, WSO2 ESB; http://wso2.org/esb WSO2 Inc.; http://wso2.org Lean . Enterprise . Middleware phone: +1 408 754 7388 ext 51789 email: [email protected]; cell: +94 77 341 3097 blog: http://blog.ruwan.org linkedin: http://www.linkedin.com/in/ruwanlinton google: http://www.google.com/profiles/ruwan.linton tweet: http://twitter.com/ruwanlinton
