Народ, появилась необходимость в автоматической генерации документации.
Облазил немного интернеты и нашел разные варианты, и само собой наткнулся на sphinx. Крутая штука и все такое, но как я понимаю она какраз нифига не автоматическая - не собирает каменты с проекта и надо руцями все описывать в отдельных файлах. Это немного не то, что надо.
Больше всего, вероятно, мне подходит документация как в админке джанги. Но проекты далеко не всегда на джанго. Кто что подскажет?
конкретно мне надо вот что:
человек пишет какой-то код и коментирует основные места. К примеру описывает каждой ф-ции описывает входные параметры. В конце написания(ну или на некоем промежуточном этапе) он запускает програмулину, которая в относительно нормальном виде выводит доки в html, к примеру.
Подскажите плиз чето)
