Документирование файлов класса Salesforce.com Apex

Поскольку язык Salesforce.com Apex похож на Java -, я хотел бы использовать javadoc или Doxygen для создания документации по API для пакета, который мы планируем выпустить на App Exchange.

Я нашел проект ApexDoc в Google Code, но он сильно ограничен и использует наивный синтаксический анализатор для генерации вывода HTML. Я скорее воспользуюсь преимуществами существующих парсеров и генераторов вывода Doxygen, чем попытаюсь заново изобрести это колесо с нуля.

Итак, мои вопросы:

1 )Кто-нибудь смог использовать javadoc или Doxygen для создания документации по API для своих классов Apex? Как ты смог это сделать?

2 )Мне интересно, насколько сложно было бы написать простой сценарий для создания серии файлов.java из файлов классов.cls Apex, добавления поддельных операторов importи, возможно, изменения некоторых объявлений, чтобы Doxygen был доволен. Любые мысли о том, что Doxygen (или javadoc )задыхаются, когда он пытается проанализировать файл Apex.cls?

Я поражен тем, что Salesforce не предоставляет такой инструмент или не предоставила синтаксический анализатор Apex для javadoc/Doxygen.Их документация и инструменты разработчика обширны, и у них есть отличная автоматизированная тестовая установка. Я ничего не нашел у них для классов автогенерации.

РЕДАКТИРОВАТЬ :Пожалуйста, просмотрите обновленную версию этого вопроса на Salesforce Stack Exchange .

7
задан Community 13 April 2017 в 12:54
поделиться