changes to documentation and variable naming