Я наталкиваюсь на небольшую кирпичную стену, пытаясь найти лучший способ реализовать автоматическую генерацию документации для проекта Django
Структура моего проекта похожа на следующую:
myproj/ # project root
|- docs/ # docs root
|- myproj/ # package root
|- app1/
|- app2/
|- app3/
utils.py
...
Я хотел бы автоматически сгенерировать документацию для всего в корневом каталоге пакета - и первоначально начал использовать sphinx-apidoc, но затем прочитал что-то, что подразумевало, что я должен вместо этого использовать autosummary и не смог найти никакой информации, описывающей, что Разница между этими двумя вариантами составляет.