Пусть будет тема.
Надеюсь, коллективный разум возьмет верх над недостатком времени и пристрастием к пиву.

Сюда будем собирать мысли, как эту штуку сделать.

Мне пока, правда, кажется, что начинать нужно с декларации используемых возможностей rst.
Ну не писать же конвертор на все случаи жизни - я бы остановился на каком-то подмножестве rst.

Далее, мне представляется стандартной схема rst->xml->als.

Вроде бы не так это сложно на первый взгляд.

Для примера я смотрел xml Math и IndexedTable.
В первом методы можно вытянуть из

/document/section (методы)/section[N]/block_quote/field_list
 

Во втором - из

/document/section (методы)/section[N]/block_quote/definition_list
/document/section (методы)/section[N]/block_quote/paragraph[N]
 

Наверное, еще будет куча нюансов.
Ну, давайте, короче, делиться мыслями.

Тогда такой вопрос (вроде как по теме), но не совсем:

Если мы будем иметь документацию в формате ReST:

1. Я думаю возникнет вопрос про плагин к OpenConf для ее просмотра в режиме Конфигуратора, и про скрипт поиска а-ля "Найти в синтакс-помощнике".


Чтобы иметь подобную документацию
2. Все таки нужен скрипт для OpenConf (для создания метода классса) который
      а) создаст конструкцию в модуле классса (Процедуру, Функцию Переменную)
      б) спросит все необходимые данные про класс (Описание, Пример, Типы Параметров)
      в) запишет в файл определенния классов данные в ПРАВИЛЬНОМ формате
      г) создаст (дополнит) ints файл класса
      д) перегенирирует файл подсказки tlb для Телепата

Может я не прав конечно, но для прихода к единому стандарту документирования, нужен инструмент для подобного документаривания, тогда и полезность конвертора rst <-> als вырастет в РАЗЫ