This repository has been archived by the owner. It is now read-only.
XSLT stylesheets to create HTML documentation from WADL files
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
README.rst update README with a link to example output. Oct 27, 2011
example.wadl
uri.xsd Bring in current docs Apr 16, 2009
wadl_documentation-2006-07.xsl Bring in current docs Apr 16, 2009
wadl_documentation-2006-10.xsl
wadl_documentation-2009-02.xsl add 2009-02 Mar 19, 2012

README.rst

CORBA has IDL; SOAP has WSDL. Developers often ask for similar capabilites for HTTP-based, "RESTful" services. While WSDL does claim support for HTTP, isn't well-positioned to take advantage of HTTP's features, nor to encourage good practice.

There are a lot of proposals in this space, but WADL is the most mature and capable. More thoughts here.

wadl_documentation.xsl is an XSL stylesheet that transforms WADL into human-readable documentation, one of many uses of a Web description format.

See an example of its output at <http://mnot.github.com/wadl_stylesheets/>.

Note that EXSLT node-set support is required, so this stylesheet will not work natively in some browsers. Try Saxon or xsltproc.

uri.xsd is a library of XML type restrictions that correspond to different components of a URI, so they can be accurately described (e.g., in a WADL param element).

Feedback is preferred on the W3C http description list.