Adding docstrings / type notation for functions

[ryul99]

Names of functions and parameters could be confused when there are no docstrings.
For example, 'hp' with no docs could be confused.
Also, In 'hp' case, I think the naming of hp is bad itself. (#9)