Maybe just add the original docstring back? When people get the deprecation warning, it can still be handy to see what the old function exactly did (and so your old code exactly did to see what you have to change)