add a comment explaining a common failure mode