added more complete docstrings

- added better referenced and more complete docstreams for all of the
functions.
- modified docstring formatting to better align with standards (google)
- cleaned up some stray cells in the examples notebook