doc(everything): enhanced the README, the docstrings