filled out venues gateway api
added some verbosity to the README file
resolve merge conflict