Mathewpeterson/add more deprecation

@dianakhuang @dmitchell @cpennington Review?
also in your docstring can you match other docstrings wrt `:class:` etc markup