@theshadowco очень даже имеет смысл постить )) Допилим. Я вот уже начал работу в этом направлении https://github.com/khorevaa/oscript-documentator
Автоматическое формирование документации из исходников
Присоединяюсь. Тоже работаю над документатором API, но делаю не свой фреймворк, а конвертер модулей в java-формат, который уже можно отправить в doxygen. Пока застопорился на парсере модуля, в целом работает, но нет времени допилить нюансы
С этой статьи я начал исследования данного вопроса.Там софт не очень гибкий - java конвертер, который понимает исходный модуль, только если там методы определены в одну строку, например. Берем БСП, в которой списки параметров вытягиваются в вертикаль, каждый на своей строке, и ловим epic fail.
Поробую в ближайшее время запостить скрипт/библиотеку, отпишусь.
подскажешь?
Коллеги, что-нибудь по автодокументаторам изменилось?
есть какой-нибудь, что сможет сгенерить md-описание по тексту модуля - bsl или os?
Недавно еще один красивый вариант нашелся от @tsukanov-as и его парсера исходников
Запуск: https://github.com/khorevaa/BSL-Parser/blob/develop/tests/oscript/docgen.os
Результат: https://khorevaa.github.io/BSL-Parser/
@JohnyDeath @Khorevaa Я попробовал.
К сожалению, получается именно тот, что на https://khorevaa.github.io/BSL-Parser/
описываются узлы, а методы не документируются.
т.е. документируется именно внутренний формат, а не внешний
видимо, где-то что нужно подпилить для получения информации из указанной AST
@artbear
Если создашь челобитную с описанием что конкретно нужно, то возможно что то я рожу в итоге.
Этот генератор конечно делался под конкретную узкую задачу. Но сделать универсальный не проблема. Непонятно только что конкретно требуется
ОФФ: челобитная - это PR
а issue именуется досадой