[Gajim-devel] Gajim API docs [and thoughts on coding standards and testing]

Torsten Bronger bronger at physik.rwth-aachen.de
Fri May 30 20:37:22 CEST 2008


Stephan Erb writes:

> [...]
> Epydoc seems to be really mighty. As far as I see we have do agree
> on a documentation style. (if we agree to use epydoc)

I strongly recommend using reStructuredText.  It may make a
transition to Doxygen more difficult but as far as I can see, Epydoc
offers everything one needs anyway.  I write my pet project with
Epydoc+reST and the resulting documentation is superb.

> Mateusz, can you tell if there is way for us to follow the python
> styleguide [0] though we are using epydoc?

Both standards are orthogonal as far as I can see.  Moreover, I
believe reST is considered standard by the Python core team.


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

More information about the Gajim-devel mailing list