added note on required API fields and shorted examples to be more readable.
changed comment block directive from shell to bash to improve highlighting
added a configuration example to the readme.
Merge pull request #13 from mreinstein/master

documentation improvements