improving docs, README, rspec tests; bumping version