update docs
revise hook compatibility