update docs, explain some hooks