documented hooks