Update docstrings

[tallamjr]

Many functions are lacking full documentation with input/output formats and examples.

To search the outstanding files, run $ ag "TODO" at the top level of astronet

[tallamjr]

Almost complete, but closing for now as low priority and can be picked up in future.