Improve docs on when model hook is called