Update docstrings to include more detail

[MLHProgram]

Each function will require a docstring. Existing functions with docstrings currently don't explain what the function should do. Update these to include parameters and return statements where necessary.

[joldov]

i can take this