changed hook call syntax and added some docs