XSLT to generate documentation from WADL

Previous Topic Next Topic
 
classic Classic list List threaded Threaded
3 messages Options
Reply | Threaded
Open this post in threaded view
|

XSLT to generate documentation from WADL

Mark Nottingham-4
I've attached a stylesheet to generate HTML documentation from WADL  
(latest revision; see <http://weblogs.java.net/blog/mhadley/archive/ 
2006/08/wadl_revision_1.html>), along with sample input and output.

I haven't tested it comprehensively, but I think it's good enough for  
testing it as well as WADL itself, to see if we're onto something here.

Feedback very much welcome.





--
Mark Nottingham
[hidden email]




wadl_documentation.xsl (27K) Download Attachment
YahooSearch.html (17K) Download Attachment
YahooSearch.xml (7K) Download Attachment
Reply | Threaded
Open this post in threaded view
|

Re: XSLT to generate documentation from WADL

Mark Nottingham-4

Thanks. I was intending to put it on a Web site, because I've already  
updated it, so:
   http://www.mnot.net/webdesc/

Cheers,


On 2006/08/08, at 10:37 AM, Jerome Louvel wrote:

>
> Hi Mark,
>
> This looks great! Maybe it would be useful to setup a Web page for  
> this
> stylesheet. We could easily point people to it, keep track of  
> updates, send
> comments, etc.
>
> I'm planning to support WADL in the Restlet project, and generating  
> nice
> documentation based on your XSLT will be very cool. See
> http://restlet.tigris.org/issues/show_bug.cgi?id=59
>
> Best regards,
>
> Jerome Louvel
> http://www.restlet.org
>
>> -----Message d'origine-----
>> De : [hidden email]
>> [mailto:[hidden email]] De la part de
>> Mark Nottingham
>> Envoyé : jeudi 3 août 2006 20:11
>> À : [hidden email]
>> Objet : XSLT to generate documentation from WADL
>>
>> I've attached a stylesheet to generate HTML documentation from WADL
>> (latest revision; see <http://weblogs.java.net/blog/mhadley/archive/
>> 2006/08/wadl_revision_1.html>), along with sample input and output.
>>
>> I haven't tested it comprehensively, but I think it's good
>> enough for
>> testing it as well as WADL itself, to see if we're onto
>> something here.
>>
>> Feedback very much welcome.
>>
>>
>>
>>
>>
>
>
>

--
Mark Nottingham
[hidden email]




Reply | Threaded
Open this post in threaded view
|

Re: XSLT to generate documentation from WADL

Mark Nottingham-4

I've made a very small update to link to simple types as well as  
elements, and to link from parameter types as well.

Additionally, I've started writing a .xsd for URI component types, so  
that there's something better than xs:string for path segments, etc.

   http://www.mnot.net/webdesc/

Comments welcome.

--
Mark Nottingham
[hidden email]