Documentation on all .ipynb functions

[dbetchkal]

All functions need documentation.

Also: we may wish to package the functions in a Python file so they can be imported from other modules?