rest.md file, with RESTful definitions