documentation for existing scripts needs to be improved

[7yl4r]

this is just a matter of testing them out and writing down details of what they do.

NOTE: this is documentation in the readme or something like that, not python docstrings.