updated explanatory comments