add additional comments for algorithm state variables