resteasy-users

[Resteasy-users] Generate service documentation?

[Chris B. <cbr...@re...>]

Hello community,

I haven't been able to find any tools that can generate service 
documentation from a set of RS-annotated interfaces.  I have pretty 
tight XSD doc generated automatically but lack doco for my services.

WADL fits the bill fairly well but I'm certainly not tied to it.  Anyone 
working on anything like this?  Have I missed a tool somewhere in the chain?

Cheers,

Chris

Re: [Resteasy-users] Generate service documentation?

[Chris B. <cbr...@re...>]

On 08/26/2010 12:15 PM, Chris Bredesen wrote:

> I haven't been able to find any tools that can generate service
> documentation from a set of RS-annotated interfaces.  I have pretty
> tight XSD doc generated automatically but lack doco for my services.
>
> WADL fits the bill fairly well but I'm certainly not tied to it.  Anyone
> working on anything like this?  Have I missed a tool somewhere in the chain?

Found this:

http://github.com/ameingast/java2wadl

It's pretty green but generated a skeleton WADL that I can hand edit and 
XSL transform into something useful.  Going that route, I think.  If 
anyone is doing something else for documentation, I'd love to hear about it.

-Chris

Re: [Resteasy-users] Generate service documentation?

[Michael M. <mmu...@re...>]

  If you need more you could look at how Jersey does it: 
http://wikis.sun.com/display/Jersey/WADL
InfoQ also caries a short article on what google and others are doing in 
this area: http://www.infoq.com/news/2007/03/WADL

Mike
> On 08/26/2010 12:15 PM, Chris Bredesen wrote:
>
>> I haven't been able to find any tools that can generate service
>> documentation from a set of RS-annotated interfaces.  I have pretty
>> tight XSD doc generated automatically but lack doco for my services.
>>
>> WADL fits the bill fairly well but I'm certainly not tied to it.  Anyone
>> working on anything like this?  Have I missed a tool somewhere in the chain?
> Found this:
>
> http://github.com/ameingast/java2wadl
>
> It's pretty green but generated a skeleton WADL that I can hand edit and
> XSL transform into something useful.  Going that route, I think.  If
> anyone is doing something else for documentation, I'd love to hear about it.
>
> -Chris
>
> ------------------------------------------------------------------------------
> Sell apps to millions through the Intel(R) Atom(Tm) Developer Program
> Be part of this innovative community and reach millions of netbook users
> worldwide. Take advantage of special opportunities to increase revenue and
> speed time-to-market. Join now, and jumpstart your future.
> http://p.sf.net/sfu/intel-atom-d2d
> _______________________________________________
> Resteasy-users mailing list
> Res...@li...
> https://lists.sourceforge.net/lists/listinfo/resteasy-users