improved readme and hook documentation