Doc generation from annotated source code

Johannes Findeisen mailman at hanez.org
Mon Nov 18 15:23:15 EST 2013


On Mon, 18 Nov 2013 14:46:46 +0100
Laszlo Nagy wrote:

> I just started rewritting my project from python 2 to python 3. I 
> noticed that there are these new parameter and return value annotations. 
> I have docstrings everywhere in my project, but I plan to convert many 
> of them into annotations. The question is: what kind of auto documenting 
> system should I use for this? Previously I have used Sphinx. Is it okay 
> to use that for python 3 source code? Is there a better alternative?

The Python docs on http://docs.python.org/3/ are generated using Sphinx
so it seems OK to do so for Python 3... ;)

Johannes



More information about the Python-list mailing list