De nuevo sobre documentacion de codigo python

Usando epydoc, ya veo una pega.
Al documentar por ejemplo las variables de clase, epydoc es capaz de extraer el tipo, pero lo que no mola nada es que con un comentario al lado de la declaración de la variables no sea capaz de extraer el comentario sobre la variable y lo tengas que hacer en el docstring.
Con pydoxy, se podría mejorar fácilmente.

Además de lo latoso que es, tiene como desventaja de que se te puede quedar documentación no actualizada si eliminas alguna variable.