improve docstrings using numpydoc standard
fix documentation typos