Снегопат

Добрый день.
А существуют ли наработки по этому вопросу?
Например по-аналогии с http://www.1cpp.ru/forum/YaBB.pl?num=1209560079
Или же адаптация существующих генераторов, вроде doxygen?

Ну, документация к самому снегопату генерится на лету из текстов в формате markdown.
Из скриптов выделяется текст между комментариями /*@ .... @*/
Но какой-то особой заточки под язык 1С, чтобы учитывался синтаксис - нет.
Возможно, что-то подобное есть в инструментах разработчика, что можно было бы взять за основу.

Классная идея кстати. Т.к. 1С и снегопат в принципе умеет парсить комментарии, можно без труда запилить документацию. Достаточно пробежаться по всем экспортным функциям и процедурам, распарсить их комментарии (в заголовки) и получить некую доку по API.

Обсуждали в чатике gitter. Есть скрипты на OneScript, которые делают что-то похожее. Но готового пока ничего нет.
Основной момент - кто будет пользоваться этими доками? Для кого они?

Доки для разработчиков. Пример: у нас 3 девелопера в команде, плюс еще архитектор иногда пописывает:) за 3 года работы накопилось уже два десятка функций (всего наверное около 1000) дублирующих друг друга. Вероятно, этого можно избежать, если будет документация. А также доки нужны для того, чтобы изучить, хотя-бы поверхностно, функционал, созданных коллегами.

Тут важно, что бы эти доки экспортировались в CHM формат (или его эквивалент). Тогда прежде чем что-то написать, будет достаточно пробежаться в поиске. Это будет полезно и для стандартных подсистем и конфигураций. Т.к. количество экспортных процедур в них измеряется тысячами их код можно изучать до пенсии. А так хоть какое-то подспорье будет.