added additional doku + example configuration and Gemfile fixes
changed example configuration to make it more generic
Merge pull request #1 from zaolin/master

Some small fixes and improvements