comments added for selected 'hook' functions