python - 在 Python 类中编写 __init__ 方法的文档字符串的首选位置在哪里？

Question

我有一个关于文档字符串标准的问题。链接:http://sphinxcontrib-napoleon.readthedocs.org/en/latest/example_google.html非常有用，但它说在 Python 类中为 init 方法编写文档字符串可以在类 header 或 init header 下完成。我想知道人们对此有何想法，即以某种方式这样做的优点和/或缺点。

Answer 1

any 方法的文档字符串应直接出现在方法定义的下方。所以我认为 init 方法的文档字符串也应该出现在其定义下方。