updated README formatting
updated Rakefile to spit out docs
make rubocop happy