documenting some hooks