document behavior when completion fails