Из руководства и документации кажется, что способ создания документации API html состоит в том, чтобы создать для каждого модуля файл my_module.rst с содержимым:
my_module
---------
.. automodule:: my_package.my_module
:members:
Я полагаю поочередно все модули может быть указан в одном файле.
У меня есть пакет с несколькими подпакетами, каждый из которых содержит довольно большое количество модулей, все они документированы с использованием строк документации.
Похоже на огромный неинтересный объем работы по созданию списка модулей вручную, которые должны быть задокументированы.
Скорее всего, это можно легко автоматизировать?