Add Params and Return Values to Docstrings

[ericnordelo]

As Andrew suggested, I think it'd be extremely helpful to others (as well as ourselves) if we make an issue for adding params and return values in our docstrings.