hopefully better docstring and self-describing code for some-hooks