documentation changes and a few variables names