added additional doku + example configuration and Gemfile fixes