added doc to README.md

Added documentation to README.md. Minor change in doc of python file
in order to make it consistent with documentation in README.md.