adds some explanatory comments