PEP 257 で docstrings の規定はあるんだけど、 コメント内容の形式には様々な表現・記述形式がある、ということで。 Python documentation standard for docstring - Stack Overflow reST の形式だと :単語:定義 でフィールドリストになるので、それにならう方法が良いのでは、というハナシ。そして、PyCharm が対応しているのもコチラというハナシを聞いた気がする。 Python - PyCharm での type hinting を使いこなす - Qiita 他、 Google Python Style Guide を見ると、 def fetch_bigtable_rows(big_table, keys, other_silly_variable=None): """Fetches rows from a Big