clean up and document utils
add a README