sphinx.ext.napoleon

NumPy および Google スタイルの docstring をドキュメントに取り込む

docstringはNumPyスタイルやGoogleスタイルのほうが読みやすい

Napoleon supports two styles of docstrings: Google and NumPy. The main difference between the two styles is that Google uses indentation to separate sections, whereas NumPy uses underlines.

「Googleスタイルはセクションの区切りにインデントを使うのに対し、NumPyスタイルは下線を使う」

NumPyスタイルはハイフンを並べて下線に見せている