documenting method and renaming a variables name