What's "the standard" for code docs?

Torsten Bronger bronger at physik.rwth-aachen.de
Fri Feb 15 12:11:23 EST 2008


Hallöchen!

Preston  Landers writes:

> [...]
>
> I've been using effbot's PythonDoc for a while, but it seems like
> "the new standard" (if there is one) is docutils and restructured
> text (ReST.)  Is that accurate?

In my opinion this is true.  And with Epydoc being the best tool for
generating documentation from the source code, Epydoc+reST is the
way to go.

Tschö,
Torsten.

-- 
Torsten Bronger, aquisgrana, europa vetus
                                      Jabber ID: bronger at jabber.org
               (See http://ime.webhop.org for further contact info.)



More information about the Python-list mailing list