minor annotation cleanup
commented routes and improved readme