simplified readme and decided on format for RESTful endpoints