Update README.rst

important change to the documentation to reflect the functionality and use of this api.