documentation changes

also renamed a variable