add some explanatory comments