Ensure good documentation for functions

[mandel01]

Here is a reference for numpy-stype docstrings

[mandel01]

Here's the numpy docstring convention I forgot to include. I am still learning more about them but the simple example below provides a nice standard structure.

def func(arg1, arg2):
    """Summary line.

    Extended description of function.

    Parameters
    ----------
    arg1 : int
        Description of arg1
    arg2 : str
        Description of arg2

    Returns
    -------
    bool
        Description of return value

    """
    return True

And here's a more complicated reference...
https://github.com/numpy/numpy/blob/master/doc/HOWTO_DOCUMENT.rst.txt