add some explanatory messages