added documentation blocks for hook listener