update to docs & REST header response codes

- now properly sets headers for RESTfull response
- commenting addd to README