extract variable, add forgotten documentation