Revamped read me based on UAT and internal validation

This pull request should not be processed until the latest stormpath-rails and stormpath-sdk gems are uploaded to Ruby Gems.