document the hook process and add some more verbosity