README improvements and clean ups. Adding more examples
README improvements and clean ups. Adding more examples

Main goal was to improve our example to lower the barrier of entry to
start using the library. I've included a link to our documentation and
clarified that producers need to worry about the KAFKA_PREFIX. Also
added a note about creating consumer groups.

meredithlind/goheroku,deadmanssnitch/sarama-heroku