Googleスタイル形式でのPython Docstringの内容が、こちらに綺麗にまとまっている。
【全般】
・ソースコードの一番始めに記載すること(importより前に記載する)
・コメントを複数行のコメントブロック「“”“」で囲む
・コメント開始の「”““」の右隣にタイトルを記載する
・コメントを閉じる「””“」は単独の行として記述する
・対象となるのは、 モジュール、クラス、関数の3つ
【セクション】
・Attributes, Args、Returns、Yieds、Raises、Examples、Note、Todoという用途別に定義されたセクションがある。
Attributes:
属性の名前 (属性の型): 属性の説明
属性の名前 (:obj:`属性の型`): 属性の説明.
Args:
引数の名前 (引数の型): 引数の説明
引数の名前 (:obj:`引数の型`, optional): 引数の説明.
Returns:
戻り値の型: 戻り値の説明 (例 : True なら成功, False なら失敗.)
Yields:
戻り値の型: 戻り値についての説明
Raises:
例外の名前: 例外の説明 (例 : 引数が指定されていない場合に発生 )
Examples:
関数の使い方について記載
>>> print_test ("test", "message")
test message
Note:
注意事項などを記載
Todo:
TODOリストを記載
* conf.pyの``sphinx.ext.todo`` を有効にしないと使用できない
* conf.pyの``todo_include_todos = True``にしないと表示されない