Google StyleのPython Docstringで、「非推奨」はどのように表せばよいでしょうか?
背景
PythonのdocstringをGoogle Styleで記載しています。
docstringの内容は、sphinxのautodoc機能でHTMLドキュメントに反映しています。
質問
非推奨のメソッドは、docstringにどのような内容を記載すればよいでしょうか?
JavaDocの@Deprecated
のようなタグを期待しています。
Example Google Style Python Docstringを読みましたが、deprecatedに関する記述は見つかりませんでした。
補足
今は、以下のようなコードを書いています。
def get_hoge(self):
"""【非推奨】hogeを取得
DEPRECATED
"""
warnings.warn("deprecated", DeprecationWarning)
pass