Решил использовать для автодокументирования сфинк. http://sphinx.pocoo.org/ И всё бы отлично, но есть такое дело, что сфинк исполняет исходный код. В большинстве случаев, это не проблема, но когда он пытается документировать какого-нибудь демона, то просто повисает, либо запускает демона и игнорирует исходный код оного. И второй случай, это когда сфинкс не может симпортить что-нибудь(исходный код на Python). В данном случае исходный код модуля игнорируется, т.е. сфинкс документирует только реально рабочий код.
Использую для всего этого автодок с такими директивами
.. automodule:: loki.apps.document.models
:members:
:undoc-members:
:show-inheritance:
