Resolve "Documentation should be improved"

[doc] added the reference to NumPy style docstrings, added note on new package instructions, added corresponding links

Closes #55 (closed)