clean up example+add RESTful hints to interface