add more documentation to variable names