document new pending behavior