more documentation for hooks