Does the current WADL spec already accommodate
creating a link to a sample representation?
If not, then I would like to see it introduced.
While the <representation> element allows
for an {element} attribute that references a
grammar, I think it would also be helpful to
introduce a reference to a sample representation,
either via a <link rel="sample" href=""/> child
element, or a {sample} attribute that contained
a URI.
This would allow for more human readable documentation
to be generated directly from the WADL itself. The one
issue I have with Nottingham's XSLT is the schema
that is injected into the resultant doc can be
overwhelming.
- Jeff