README, docstring improvements
idiom