document hooks in src, improve readme