usability docs
add running documentation
a bit of a cleanup