Mathewpeterson/add more deprecation

@dianakhuang @dmitchell @cpennington Review?
Please use the `:class:` etc markup used in other docstrings.