changed documentation and variable names