[rest-practices] Piece on RESTful API Design

[Geert Jansen]

Hi,

i wanted to do this for a long time, and finally got it it. See the link 
below for an essay on RESTful API design, based on lessons learnt from 
rhevm-api project:

http://readthedocs.org/docs/restful-api-design/en/latest/

 From the intro: "This is essay is an attempt to put down my thoughts on 
how to design a real-world yet beautiful RESTful API." It goes into such 
topics as JSON vs XML, why not XMLSchema, creating CLIs, and more.

Mark, it also contains a worked out version of your idea to use forms 
for describing inputs.

Feedback is welcome!

Regards,
Geert