> -----Original Message----- > From: KARR, DAVID (ATTSI) > Sent: Wednesday, April 20, 2011 2:59 PM > To: [email protected] > Subject: How to properly set "title" in generated WADL > > My controller class has a @Description annotation with both "title" and > "value" properties. > > Here is an abbreviated excerpt from the generated WADL: > ------------------ > <resources base="http://myuri";> > <resource path="mypath"> > <doc title="mytitle">mydescription</doc> > ------------------ > > This all seems reasonable. I'm trying to use a spreadsheet that > generates docs from a WADL, from < > https://github.com/mnot/wadl_stylesheets>. It mostly works, but it's > not getting my title value. This is possibly just a XSLT bug in the > spreadsheet, or perhaps there are different interpretations of where > the title should go.
Ok, I think I see one issue. This stylesheet is checking for the "doc" element in the "application" element, but CXF's @Description annotation on the controller results in putting the title and description in the "resource" element. It sounds like any documentation at the "application" level wouldn't be in the Controller, it would have to be in the "jaxrs:server" element, at least.
