[IMP] slightly improve README
[IMP] improve test docstrings