docs for new hook