add background notes on scenarios and workflows discussed with ron
update README with details on naming conventions, response codes, authentication, and versioning