refactoring documment of change variables