They tend to be easier to read than reST, and happen to be used by the packages I use most (numpy, scipy). They are also easily worked into sphynx/napoleon.
2 questions:
1.) Why use reST instead?
2.) Why isn't there a python-wide standard or best practices as is found for Scala/Java/others?
I use Sphinx style because it gives me better auto-completion via Jedi[1][2]. Otherwise I really like the look of Google style docstrings[3]. There's some ongoing work[4][5] to get support for that in Jedi as well.
That's referring to the syntax in the docstring format they developed is only supported by reST, render by Sphinx's integration with reST. For exmaple,
https://github.com/numpy/numpy/blob/master/doc/HOWTO_DOCUMEN...
They tend to be easier to read than reST, and happen to be used by the packages I use most (numpy, scipy). They are also easily worked into sphynx/napoleon.
2 questions:
1.) Why use reST instead?
2.) Why isn't there a python-wide standard or best practices as is found for Scala/Java/others?