fixed typo and improved grammar in README.rst; added more code documentation