The behavior of how the `--wait` flag interacts with the hook lifecycle
was not documented. This adds clarification on the lifecycle behavior
with the `--wait` flag.