DOC: consolidate replace API changes