[Numpy-discussion] Docstring page, out of date?
Tue Jan 22 00:08:14 CST 2008
David Cournapeau wrote:
> Nobody likes to write doc, specially if you have to follow many rules.
> Not being able to see the result does not help. I don't know much
> about the current documation tools situation with python, but I have
> seen good, automatically generated doc for python modules: for
> example, the current developement doc of python
> (http://docs.python.org/dev/) looks pretty good to me, and using the
> same tools as python makes more sense than forking our own, no ? Or am
> I missing something fundamental ?
Yes. Sphinx does not do automatically generated documentation.
"I have come to believe that the whole world is an enigma, a harmless enigma
that is made terrible by our own mad attempt to interpret it as though it had
an underlying truth."
-- Umberto Eco
More information about the Numpy-discussion