""

"The URI for a resource element is obtained using the following rules:

Set identifier equal to the URI computed (using this process) for the parent element (resource or resources)
If identifier doesn't end with a '/' then append a '/' character to identifier
Substitute the values of any URI template parameters into the value of the path attribute
Append the value obtained in the previous step to identifier
For each child param element (see section 2.12), in document order, that has a value of 'matrix' for its style attribute, append a representation of the parameter value to identifier according to the following rules:
Non-boolean matrix parameters are represented as: ';' name '=' value
Boolean matrix parameters are represented as: ';' name when value is true and are omitted from identifier when value is false
where name is the value of the param element's name attribute and value is the runtime value of the parameter."

boolean, float, double, dateTime, base64Binary, anyType, long, short, int, string

Overview of RESTful param types in WADL

"Last week saw the release of three new WADL frameworks:"

Nice overview from 2006 of the potential pitfalls ahead with WADL

"Let’s talk APIGEE for a Colorado-second; it’s an awesome API tool I’ve come to love for numerous reasons — the most obvious being the ease-of-use it brings to deploying new features [and it seems like we do that quite a bit at Isidorey].  One of the things that seemed necessary, at least to cut down on the time I spent documenting [who am I kidding, I pushed as much of that off to the interns as I could :)], was being able to generate all of the API documentation from the XML [wadl] file that APIGEE uses. "

REST Describe & Compile is an editor and a compiler for (REST) Web Services that are described in Sun engineer Marc Hadley's Web Application Description Language, or short WADL. In order to use REST Describe & Compile you do not necessarily need to understand what WADL is, it is a good idea to have heard at least of the basics though. In consequence, in the following let me explain the absolute minimum of what I consider good to know.