Documentar código con docstrings

Hola,

Estaba escribiendo unas 'guidelines' para python (sin inventar nada, claro..
básicamente siguiendo el PEP 8) y hay un punto sobre el que no encuentro
algo que me convenza.
Anteriormente he usado epydoc para generar la documentación (parece que este
proyecto está un poco parado, ¿puede ser?) pero estaba por la labor de algo
mas pythoniano....

La cuestión es que no encuentro una especificación que me convenza; es todo
muy genérico. Y preferiría no tenermelo que inventar...
¿Sabeis de alguna especificación que merezca la pena?

Saludos!
_______________________________________________
Lista de correo Python-es 
http://listas.aditel.org/listinfo/python-es
FAQ: http://listas.aditel.org/faqpyes