Update README.md

Updated with better documentation for both rake and api methods