inline docs for hooks