Mathewpeterson/add more deprecation

@dianakhuang @dmitchell @cpennington Review?
Generally within this `replace` there needs to be some comments/docstring explaining what the logic behind what you're doing is.