You should add a note on the deprecation either here or at the end of the docstring.