Services documentation
All, I know the WSDL is to service as a documentation tool to identify what services are available and how to connect them, but I'm looking for something a little more that I could hand over to clients. I was looking at a couple of tools that take the WSDL and generate some javadoc like documentation that seemed to work OK, however I have a small issue. I have placed xsd:documentation throughout my schema and it seems as though the WSDL that is being generated by CXF, all documentation elements have been removed. Is there a way to control this? Also, do any of you have any recommendations for tools/products to look at? Does CXF have anything built in for this? Thanks all, Eric
Re: Services documentation
Well, I was mistaken that CXF was stripping the documentation elements. Sorry for the false alarm. :) However, is there a way to add documentation elements to the generated WSDL? I thought XFire provided this (there is a link on the old XFire site to documenting the WSDL), has this feature made it's way over to CXF? If so, how does one go about doing this? Thanks again, Eric On Thu, 2008-02-21 at 12:22 -0500, Eric Miles wrote: > All, > > I know the WSDL is to service as a documentation tool to identify what > services are available and how to connect them, but I'm looking for > something a little more that I could hand over to clients. I was > looking at a couple of tools that take the WSDL and generate some > javadoc like documentation that seemed to work OK, however I have a > small issue. I have placed xsd:documentation throughout my schema and > it seems as though the WSDL that is being generated by CXF, all > documentation elements have been removed. Is there a way to control > this? > > Also, do any of you have any recommendations for tools/products to look > at? Does CXF have anything built in for this? > > Thanks all, > Eric
Re: Services documentation
On Thursday 21 February 2008, Eric Miles wrote: > Well, I was mistaken that CXF was stripping the documentation > elements. Sorry for the false alarm. :) > > However, is there a way to add documentation elements to the generated > WSDL? I thought XFire provided this (there is a link on the old XFire > site to documenting the WSDL), has this feature made it's way over to > CXF? If so, how does one go about doing this? This feature hasn't made it over. :-( I guess log a jira. Dan > > Thanks again, > Eric > > On Thu, 2008-02-21 at 12:22 -0500, Eric Miles wrote: > > All, > > > > I know the WSDL is to service as a documentation tool to identify > > what services are available and how to connect them, but I'm looking > > for something a little more that I could hand over to clients. I > > was looking at a couple of tools that take the WSDL and generate > > some javadoc like documentation that seemed to work OK, however I > > have a small issue. I have placed xsd:documentation throughout my > > schema and it seems as though the WSDL that is being generated by > > CXF, all documentation elements have been removed. Is there a way > > to control this? > > > > Also, do any of you have any recommendations for tools/products to > > look at? Does CXF have anything built in for this? > > > > Thanks all, > > Eric -- J. Daniel Kulp Principal Engineer, IONA [EMAIL PROTECTED] http://www.dankulp.com/blog
