clean up doc strings
more doc strings
renamed a few variables