push
added basic documentation for hook functions