-
Notifications
You must be signed in to change notification settings - Fork 192
[Feature] Add docs #63
Comments
|
Any good document that shows how the docstrings should look for sphinx compatibility? I find there website a bit messy. Perhaps some samples how to document function parameters, return type would be nice. |
I personally like the Google style docstrings:
This is how it's done in neo-boa:
Here is another example with: |
I started converting #74 to rST format as requested by @localhuman here. Unfortunately also that standard leaves room for interpretation / free will. Before having to edit everything a 3rd time I'd like to get to an agreement on how to document the following:
multiple return typesExample with current Sphinx Napoleon format:
Attempt 1:
Attempt 2 (suggested here):
Exception documentationExample:
PyCharm format:
Note that I'm uncertain here if I should repeat Sphynx doc example
NotesCurrent:
Attempt (ok?)
|
This is by no means finished, but a WIP here: http://neo-python.readthedocs.io/en/latest/index.html Currently working out of the |
It's probably good to say we settled on using Google's docstring notation and no longer the rST format discussed just above. |
This is complete, though further documentation would never hurt. |
Add actual documentation to the project.
The text was updated successfully, but these errors were encountered: