update README, add more detailed instructions on setup and usage

I followed the README today to integrate my Hubot into our new Kato organization and noticed some areas that could be explained a little better in the documentation.

This PR adds more information regarding setup, usage and fixes some typos + formatting.