document `pending`