Mohan Parthasarathy schrieb:
I am a newbie and about a month old with Python. There is a wealth of
material about Python and I am really enjoying learning Python.
One thing that could have helped Python documentation is that instead of the
very "raw" doc string, it could have used something like PythonDoc (java doc
style) so that the functions/classes are documented better. At least I am
planning to use PythonDoc for the code that I am going to write. Let me know
if there is a better one..
Several projects are trying to improve the doc strings with an extended
syntax. Personally I prefer the epytext syntax from epydoc [1]. It's a
JavaDoc like markup language that extends the raw doc strings with
useful information.
Christian
[1] http://epydoc.sourceforge.net/manual-epytext.html
--
http://mail.python.org/mailman/listinfo/python-list
