doc updates on replace