document pre_run hook