Update README.md

Order of functions' parameters have been inverted
Improved doc in general