more docs; some gemfile changes