There is something w/in JBoss JAX-RS tools (got some pointers via twitter).<div><br></div><div>E.g. this was generated out of it (mostly)</div><div><br></div><div><a href="http://docs.redhat.com/docs/en-US/JBoss_Operations_Network/3.1/html/Rest_API/index.html">http://docs.redhat.com/docs/en-US/JBoss_Operations_Network/3.1/html/Rest_API/index.html</a></div>
<div><br></div><div>It basically uses this:</div><div><a href="http://git.fedorahosted.org/cgit/rhq/rhq.git/tree/modules/helpers/rest-docs-generator">http://git.fedorahosted.org/cgit/rhq/rhq.git/tree/modules/helpers/rest-docs-generator</a></div>
<div><br></div><div>and some maven fu ... :-)</div><div><br></div><div><div>-M<br><br><div class="gmail_quote">On Thu, Aug 16, 2012 at 4:23 PM, Bruno Oliveira <span dir="ltr">&lt;<a href="mailto:bruno@abstractj.org" target="_blank">bruno@abstractj.org</a>&gt;</span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
                <div>WADL reminds me of SOAP times :) I would rather to go with an alternative like this <a href="https://github.com/rails/activeresource" target="_blank">https://github.com/rails/activeresource</a>
                </div><div><br></div><div>Unfortunately I only know Javadoc and WADL. We try to find an alternative to generate REST endpoints documentation.</div>
                <div><div><br></div><div>Let me know what do you think and feel free to add a task for me on M6, if you want  :)</div><div><br></div><div><div>-- </div><div>&quot;The measure of a man is what he does with power&quot; - Plato</div>
<div>-</div><div>@abstractj</div><div>-</div><div>Volenti Nihil Difficile</div></div></div><div><div class="h5">
                 
                <p style="color:#a0a0a8">On Wednesday, August 15, 2012 at 6:40 AM, Matthias Wessendorf wrote:</p>
                </div></div><blockquote type="cite" style="border-left-style:solid;border-width:1px;margin-left:0px;padding-left:10px">
                    <span><div><div><div><div class="h5"><div>Hi,</div><div><br></div><div>looking at [1] and I am wondering if there is a tool that generated</div><div>&#39;human readable&#39; description of restful endpoints</div>
<div>(e.g. out of the jaxrs @nnotations + provided javadoc).</div><div><br></div><div>Or is the only option really Web Application Description Language</div><div>(WADL), see [2] and [3].</div><div><br></div><div>Thx!</div>
<div>Matthias</div><div><br></div><div>[1] <a href="https://github.com/aerogear/as-quickstarts/blob/master/kitchensink-html5-mobile/SERVICES.md" target="_blank">https://github.com/aerogear/as-quickstarts/blob/master/kitchensink-html5-mobile/SERVICES.md</a></div>
<div>[2] <a href="http://www.w3.org/Submission/wadl/" target="_blank">http://www.w3.org/Submission/wadl/</a></div><div>[3] <a href="http://cxf.apache.org/docs/jaxrs-services-description.html" target="_blank">http://cxf.apache.org/docs/jaxrs-services-description.html</a></div>
<div><br></div><div>-- </div><div>Matthias Wessendorf</div><div><br></div><div>blog: <a href="http://matthiaswessendorf.wordpress.com" target="_blank">http://matthiaswessendorf.wordpress.com</a>/</div><div>sessions: <a href="http://www.slideshare.net/mwessendorf" target="_blank">http://www.slideshare.net/mwessendorf</a></div>
<div>twitter: <a href="http://twitter.com/mwessendorf" target="_blank">http://twitter.com/mwessendorf</a></div></div></div><div>_______________________________________________</div><div>aerogear-dev mailing list</div><div>
<a href="mailto:aerogear-dev@lists.jboss.org" target="_blank">aerogear-dev@lists.jboss.org</a></div><div><a href="https://lists.jboss.org/mailman/listinfo/aerogear-dev" target="_blank">https://lists.jboss.org/mailman/listinfo/aerogear-dev</a></div>
</div></div></span>
                 
                 
                 
                 
                </blockquote>
                 
                <div>
                    <br>
                </div>
            </blockquote></div><br><br clear="all"><div><br></div>-- <br>Matthias Wessendorf <br><br>blog: <a href="http://matthiaswessendorf.wordpress.com/" target="_blank">http://matthiaswessendorf.wordpress.com/</a><br>
sessions: <a href="http://www.slideshare.net/mwessendorf" target="_blank">http://www.slideshare.net/mwessendorf</a><br>twitter: <a href="http://twitter.com/mwessendorf" target="_blank">http://twitter.com/mwessendorf</a><br>

</div></div>