doc update with deprecated