installation instructions in README
improve docstring