Closed Qwlouse closed 9 years ago
I like Numpy and Google styles since they look better in code. Particularly, the Google style, since it's the simplest to write. Are type hints really a big gain for this project? Also, is it likely that PyCharm will soon pick up type hints from other styles?
Also, we could just use annotations to get type hints, regardless of what style we use. Correct?
IMHO type hints help quite a bit with coding and avoiding mistakes, but it is not essential of course.
There is a feature request for PyCharm here: https://youtrack.jetbrains.com/issue/PY-9795 which has about 100 votes (you can only see them when logged in). But it is already over two years old and there is no feedback from Jetbrains.
We could use annotations but that means dropping Python 2 support.
Alright, let's stick to restructured text then. @untom, Cool?
:+1:
How should we format the docstrings? I do like the numpy style, but PyCharm doesn't seem to pick up type hints from them.
Example Numpy (no pycharm support):
Google style:
Pycharm works fine with reStructuredText:
Epytext also works and is very similar except for the usage of
@
:Sphinx should be able to support all of them.