more descriptive method and README update
remove deprecation warning from rspec